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Preface 



Peut-etre nos activites, aux uns et aux autres, nous laisseront-elles un 
jour le temps de regarder avec assez de recul l'aventure incroyable de 
cette technologie quest Java ? En seulement dix ans, Java s'est impose la 
ou on ne devinait que la domination d'un seul modele economique. 
Aujourd'hui, la majorite des grands projets, tout comme la plupart des 
grands acteurs de 1'informatique, s'appuient sur cette technologie. Pour 
etre plus precis, il faudrait dire : « s'accrochent a sa dynamique ». Qui 
l'aurait parie ? 

Avec l'emergence du navigateur Internet sur nos bureaux virtuels depuis le 
milieu des annees 1990, Java est passe de ce petit bonhomme jongleur ani- 
mant inutilement les pages web a cet impressionnant ensemble d'API per- 
mettant la refonte complete de nos systemes informatiques d'entreprise. 

Dans ce tourbillon technologique, nous sommes tous invites a trouver 
notre chemin. D'abord, les entreprises dont le metier est de s'adapter aux 
nouvelles contraintes et aux nouveaux modeles economiques (logiciel libre, 
par exemple). Mais aussi, les personnes de la galaxie informatique a qui on 
demande de tout savoir, sans toujours comprendre que la maitrise de tant 
de concepts pose un vrai probleme de competences et de formations. 

Le Conservatoire National des Arts et Metiers est l'un des interlocuteurs 
► http://www.cnam.fr de ces personnes desireuses de voir leurs competences evoluer de facon 

coherente avec les offres de solutions technologiques et d'emplois. C'est 
dans le cadre de cette honorable et toujours jeune institution du Cnam 
que j'ai eu la chance de connaitre Antonio Goncalves. C'est ensemble que 
nous nous sommes poses la question de notre contribution a ce rapport 
difficile entre revolution de la technologie et revolution des competences 
des professionnels qui viennent nous entendre sur ces sujets. 



Autant vous dire que le boulot n'est pas de tout repos ! Depuis quelques 
annees, c'est au plus tous les deux ans que nous devons nous remettre en 
cause et changer non seulement de solutions mais de discours. Nos audi- 
teurs, qui sont des professionnels, sont d'ailleurs les premiers a nous 
interpeller pour nous signaler que telle ou telle nouvelle solution 
s'impose au marche et done aux acteurs que nous sommes. II arrive alors 
que ce soit des anciens auditeurs, devenus des architectes Java EE 
avertis, qui, passionnes par leur metier comme par la transmission de 
leur savoir, viennent renforcer nos equipes pedagogiques et contribuer 
ainsi a la pertinence de notre offre. C'est le cas d'Antonio, qui est a la 
fois architecte de grands projets Java EE et enseignant au Cnam, pour la 
plus grande satisfaction de ses collegues et surtout de ses auditeurs. 

C'est en grande partie dans ce contexte que s'inscrit le livre que vous avez 
entre les mains. L'idee en est nee de plusieurs annees de contributions a la 
formation Java EE au Cnam. L'orientation pragmatique de l'ouvrage est 
issue de la bonne connaissance de la demande de nos auditeurs. 

Le pari de ce livre est de vous donner le moyen de penetrer chacune de 
ces nouvelles technologies, par la pratique, et dans le cadre structurant 
d'un projet connu de tous pour etre le projet de reference en la matiere. 

J'espere que ce livre aura 1' audience qu'il merite aupres de tous ceux qui 
ne se contentent pas de simples generalites. En tout cas, je suis sur qu'il 
aura aupres de nos etudiants a Paris et dans son reseau national, l'impact 
pedagogique dont nous avons besoin pour relever ce defi. 

Professeur Louis Dewez 

Departement STIC, Cnam 



Avant-propos 



Java EE 5 



La version finale de la specification Java EE 5 date 
de juillet 2006. 

Retrouvez en annexe A la liste exhaustive des spe- 
cifications qui constituent Java EE 5. 



Java Enterprise Edition est apparue a la fin des annees 1990 et a apporte 
au langage Java une plate-forme logicielle robuste pour les applications 
d'entreprise. Remise en cause a chaque nouvelle version, mal comprise 
ou mal utilisee, concurrence^ par les frameworks Open Source, elle a su 
tirer profit de ces critiques pour s'ameliorer et trouver un equilibre dans 
sa version Java EE 5. 

La deuxieme edition de cet ouvrage, mise a jour et enrichie, propose de 
decouvrir les nouveautes de cette version, tout en examinant comment les 
assembler pour developper un site de commerce electronique. 



Objectifs de cet ouvrage 

Servlet, JMS, EJB, JSP, JPA, MDB, JSF. . . , la liste des specifications qui 
constituent Java EE 5 et qui doivent etre connues par ses adeptes est 
longue. L'objectif de ce livre est ambitieux puisqu'il se propose de vous 
guider dans le developpement d'un site de commerce electronique en 
utilisant la plupart de ces specifications. 

Java EE 5 est constitue de plus d'une vingtaine de specifications, cha- 
cune faisant l'objet d'une description precise dans un document relative- 
ment volumineux (par exemple, 330 pages pour les servlets 2.5 ou 
encore 646 pour les EJB 3.0). Vous trouverez done, dans la litterature 
informatique et sur Internet, une multitude de mini applications de type 
« Hello World » ainsi que des tutoriels couvrant chacune de ces specifi- 
cations de maniere isolee. Ce nest pas le but de cet ouvrage. Son objectif 
est de vous guider dans le developpement d'un site complet de com- 
merce electronique, tout en repondant a la question « Comment faire 
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I Java Pet Store 

E 

§, Faisant partie du programme des BluePrints de 

£ Sun Microsystems, I'application Java Pet Store est 

■g un site de commerce electronique utilisant les spe- 

£ cifications Java EE. 

► http://java.sun.com/reference/blueprints/ 



GlassFish 

GlassFish est un serveur d'applications que Sun a 
donne a la communaute Open Source. 



Derby 

Derby est une base de donnees relationnelle Open 
Source. 



Sources 

Le code source de I'application developpee dans ce 
livre est disponible en ligne sur le site : 
► http://www.antoniogoncalves.org 
Vous y trouverez aussi d'autres ressources telles 
qu'un forum pour deposer vos remarques ou 
echanger de I'information. 



pour assembler ces specifications ? ». La structure de 1'application suit les 
regies de Fart en matiere d'architecture : decoupage en couches, couplage 
lache et design patterns. 

Afin de vous raccrocher a des concepts et pratiques connus de la commu- 
naute Java, cet ouvrage s'inspire du Java Pet Store de Sun et vous servira de 
guide dans le developpement d'un site web proche de cette application. De 
plus, ce livre couvre une large partie des specifications Java EE 5, utilise la 
version 5 du JDK, les design patterns, ainsi que le serveur GlassFish et la 
base de donnees Derby pour executer I'application. II est abondamment 
illustre de diagrammes UML, d'extraits de code et de captures d'ecrans. 
Enfin, les pages de ce livre sont accompagnees de notes, de remarques et 
de references pour vous permettre d'approfondir vos connaissances. Le 
developpement de cette application est fait de maniere incrementielle, afin 
d'apprehender au fur et a mesure chacune des specifications. 

A qui s'adresse cet ouvrage ? 

Le but de ce livre n'est pas de detailler la syntaxe du langage Java ou 
encore l'ensemble des methodes des classes constituant l'API EJB. Si tel 
etait le cas, vous ne pourriez l'emporter avec vous, a moins de posseder 
une brouette, en raison de son volume et de son poids. 

Cet ouvrage s'adresse avant tout a des lecteurs ayant un niveau avance en 
Java/UML et quelques connaissances en developpement web. 

II est egalement dedie aux architectes souhaitant comprendre comment 
imbriquer les differentes API de Java EE 5 pour realiser une application 
Internet-intranet. 

Les debutants et les etudiants y trouveront aussi leur compte en utilisant 
les multiples references que contient ce livre. Ces dernieres leur permet- 
tront d'approfondir un sujet en particulier. 

www.avaxhome.ws 

Structure du livre 

Le chapitre 1 presente l'etude de cas d'une application de commerce 
electronique inspiree du blueprint Java Pet Store de Sun. La societe Ac- 
tive YAPS veut informatiser son activite de vente d'animaux domesti- 
ques. Pour ce faire, elle a besoin d'un site pour les internautes, d'un 
client riche pour ses employes et de dialoguer avec ses partenaires 
externes (banque et transporteur). 

UML, cas d'utilisation. 
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Le chapitre2 se concentre sur l'architecture technique et logicielle de 
l'application YAPS Pet Store. Ce chapitre presente brievement les outils 
et API utilises pour le developpement. 

Java 5, HTML, XML, Java EE 5, Blueprint, design pattern, UML. 
^installation et la configuration des outils se fait au chapitre 3. 
JDK, Ant, GlassFish, Derby, TopLink. 

Le developpement de l'application utilisant une approche bottom-up, le 
chapitre 4 entre dans le vif du sujet en developpant les objets persistants. 

JPA, entity. 

Le chapitre 5 rajoute une couche de traitements metiers venant mani- 
puler les objets persistants. 

EJB stateless, entity manager, JPQL. 

Le chapitre 6 nous explique comment compiler et deployer l'application 
pour quelle soit utilisee par une IHM Swing. 

Ant, JNDI, Swing, GlassFish, TopLink, Derby. 

Le chapitre 7 cree une premiere version de l'application web qui permet 
de visualiser le catalogue des articles de la societe et de gerer Faeces des 
clients. 

JSP, JSTL, JSF, Unified Expression Language. 

Le chapitre 8 rajoute un panier electronique au site pour pouvoir acheter 
des animaux domestiques en ligne. 

EJB stateful. 

Le chapitre 9 s'interesse aux echanges B2B entre la societe YAPS et ses 
partenaires externes (banque et transporteur). 

Web Service, WSDL, SoapJAXB. 

Les traitements asynchrones, comme l'impression d'un bon de com- 
mande ou l'envoi d'e-mails, sont developpes au chapitre 10. 

JMS, message-driven bean, JavaMail. 

LannexeA repertorie de maniere exhaustive les specifications consti- 
tuant Java EE 5. LannexeB fournit le code complet des taches ant 
employees pour compiler et deployer l'application. Lannexe C liste les 
sigles et acronymes que vous retrouverez dans cet ouvrage alors que 
1'annexeD compare les EJB 2.1 et les EJB 3.0. Enfin, l'annexe E vous 
guide pas a pas dans le developpement d'une application web Java EE 5 
utilisant l'IDE IntelliJ IDEA. 



A Top-down et bottom-up 

L'approche top-down preconise de developper une 
application de haut en bas, e'est a-dire en com- 
mencant par les couches de presentations 
jusqu'aux couches d'acces aux donnees 
L'approche bottom-up consiste a faire le chemin 
inverse. 
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Presentation de I'etude de cas 



SOMMAIRE 

Ce chapitre presente de maniere globale l'etude de cas que 
nous allons developper tout au long de cet ouvrage : un site 
de commerce electronique, specialise dans la vente d'animaux 
domestiques. Afin de decrire les besoins de la societe YAPS, 
nous utiliserons des diagrammes de cas d'utilisation 
et d'activite UML ainsi que des maquettes d'ecrans. 

MOTS-CLES 

► UML 

► Cas d'utilisation 

► Acteurs du systeme 

► Diagramme d'activite 

► Maquettes d'ecrans 

► Java Pet Store 

avaxhome.ws 



► Presentation de la societe YAPS 

► Application YAPS Pet Store 

► Acheter des animaux en ligne 

► Site de commerce electronique 

► Expression des besoins 

► Cas d'utilisation et acteurs 
du systeme 



Telecharger YAPS Pet Store 



Retrouvez le site YAPS Pet Store a I'adresse 
suivante : 

► http://www.antoniogoncalves.org 



Cet ouvrage repose sur l'analyse du systeme d'information et plus particu- 
lierement du systeme informatique de l'entreprise fictive YAPS. Cette 
societe americaine vend des animaux de compagnie. Elle continue 
d'exercer son metier tel quelle le faisait a ses debuts, c'est-a-dire quelle 
repertorie ses clients et ses articles sur des fiches de papier bristol, recoit les 
commandes par fax, les cheques par courrier puis envoie le bon de com- 
mande au client. Une fois le cheque encaisse par la banque BarkBank, elle 
utilise la societe de transport PetEx pour acheminer les animaux vers leurs 
nouveaux proprietaires. YAPS est depuis toujours implantee dans le sud de 
la Californie ou sont domicilies ses principaux clients. 

Recemment, elle a ouvert son marche a d'autres etats americains, ainsi 
qua l'etranger. YAPS n' arrive plus a gerer manuellement cette expansion 
et souhaite creer un systeme informatique pour lui permettre de faire 
face a sa recente croissance. Elle attend de celui-ci qu'il lui permette de 
vendre ses animaux en ligne, de gerer son catalogue d'articles et sa base 
de donnees de clients. De plus, ses partenaires (la banque BarkBank et la 
societe de transport PetEx) souhaitent avoir la possibilite d'echanger des 
donnees aux formats electroniques via Internet. 

Ce systeme informatique est baptise « YAPS Pet Store ». II doit 
repondre a certains besoins en termes de performance et de robustesse 
comme la haute disponibilite puisque le site doit etre accessible 24h/24 
et 7)17 , et supporter un nombre eleve d'internautes. En effet, bien que 
YAPS soit presente dans le monde entier, la majeure partie de ses clients 
se trouve aux Etats-Unis. II faut done prevoir une hausse des acces au 
systeme durant la journee. 



Expression des besoins 

UML Les createurs du langage Pour exprimer les besoins de la societe YAPS, nous allons utiliser le for- 

James Rumbaugh, Grady Booch et Ivar Jacobs sont malisme UML des cas d'utilisation. Ces derniers ont ete developpes par 
les createurs du langage UML. Ivar Jacobson bien avant 1' apparition d'UML {Unified Modeling Lan- 

guage), lis ont ete integres a ce langage de modelisation pour representer 
les fonctionnalites du systeme du point de vue utilisateur. lis permettent 
de modeliser des processus metier en les decoupant en scenarii. Les cas 
d'utilisation sont normalement representes par un schema, puis enrichis 
par un document decrivant plus precisement chaque cas ainsi que d'une 
maquette de l'interface graphique et/ou d'un diagramme d'activites. 

Le diagramme de cas d'utilisation se compose : 

• d'acteurs : ce sont les entites externes (personne humaine ou robot) 
qui utilisent le systeme ; 

• de cas d'utilisation : ce sont les fonctionnalites proposees par le systeme. 
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Diagramme de cas (('utilisation 

Le diagramme de cas d'utilisation ci-apres decrit les besoins de la societe 
YAPS de facon synthetique et peut etre lu comme ceci : « Un employe 
peut gerer les articles du catalogue, gerer les clients, visualiser et sup- 
primer les commandes. Un internaute peut se creer un compte, visualiser 
et rechercher un article dans le catalogue... ». 



UML Le systeme a etudier 



Dans un diagramme de cas d'utilisation, les rec- 
tangles autour desquels gravitent les acteurs sym- 
bolisent les systemes a etudier. Les acteurs sont 
representes par une icone (appelee stick man), 
alors que les cas d'utilisation sont representes par 
une forme ovale. 



Q_ 

I 



Employe 



YAPSPetsiore 




UML La relation «Extend» 

Notez la presence de la relation «Extend». 
Cela signifie que le cas d'utilisation incorpore de 
maniere facultative un autre cas d'utilisation. Dans 
notre exemple, on cree un bon de commande si 
I'achat d'articles a ete effectue. 



UML La relation «lnclude» 

La relation «Include» signifie que le cas 
d'utilisation incorpore explicitement et de maniere 
obligatoire un autre cas d'utilisation. Dans notre 
exemple, lorsqu'on achete des articles, les donnees 
de la carte bancaire sont obligatoirement validees. 



Figure 1-1 

Diagramme de cas d'utilisation 



Les acteurs du systeme 

Les acteurs humains qui utilisent le systeme YAPS Pet Store sont les 
suivants : 

• Employe : les employes de la societe YAPS s'occupent de mettre a 
jour le catalogue des articles ainsi que la liste des clients. lis peuvent 
aussi consulter les commandes passees en ligne par les clients. 

• Internaute : il s'agit d'une personne anonyme qui visite le site pour 
consulter le catalogue d'animaux domestiques. Si l'internaute veut 
acheter un animal, il doit d'abord creer un compte. II devient alors un 
client de la societe YAPS. 

• Client : un client peut visualiser le catalogue, modifier ses coordon- 
nees et acheter des articles en ligne. Dans ce dernier cas, il recoit une 
confirmation de sa commande et se fait livrer a domicile. 
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II faut egalement mentionner ici les systemes informatiques externes, 
utilises par la societe YAPS : 

• BarkBank : YAPS delegue la validation des cartes bancaires a la 
banque BarBank. 

• PetEx : la livraison des animaux est assuree par la societe de transport 
PetEx. Celle-ci se rend a l'entrepot de YAPS, charge les animaux 
dans ses camions, puis les achemine chez les clients. 



Les cas (('utilisation 



A Client leger, riche et lourd 

Ne avec les technologies du Web, le client leger 
designe un poste utilisateur dont la fonction se 
limite a interpreter I'affichage de pages web. Le 
client riche se limite a afficher les donnees mais en 
utilisant des API Java telles que Swing et necessite 
un deploiement (Java Web Start). Issu des architec- 
tures client-serveur, le client lourd designe un 
poste utilisateur (en Swing, par exemple) effec- 
tuant en plus de I'affichage, une part de traite- 
ments metier. 



Chaque cas d'utilisation represente dans le diagramme precedent doit 
etre complete d'un texte explicatif. Bien que le formalisme de ce texte ne 
soit pas specifie dans UML, il possede frequemment les rubriques 
suivantes : 

• Nom : le plus souvent le nom contient un verbe a l'infinitif puisqu'un 
cas d'utilisation decrit une interaction entre un acteur et le systeme. 

• Resume : une breve description du cas d'utilisation. 

• Acteurs : cette rubrique decrit la liste des acteurs interagissant avec le 
cas d'utilisation. 

• Pre-conditions (optionnel) : ce sont les conditions necessaires pour 
declencher le cas d'utilisation. 

• Description : cette rubrique contient un texte explicitant le cas d'uti- 
lisation. 

• Post-conditions (optionnel) : ce sont les conditions remplies apres 
l'execution du cas d'utilisation (etat du systeme apres realisation du 
cas d'utilisation). 

• Exceptions (optionnel) : un cas d'utilisation decrit le comportement 
du systeme lorsqu'il n'y a pas d'exception. Si une exception est levee, 
elle doit etre decrite dans cette rubrique. 

Lorsque le cas d'utilisation est lie a un acteur humain (« Gerer les 
clients », « Visualiser le catalogue »...), cela signifie que cet acteur a 
besoin d'interagir avec le systeme. II faut done lui associer une interface 
graphique. L'internaute et le client utilisent leur navigateur web pour 
acceder au systeme informatique (client leger), alors que les employes uti- 
lisent une application graphique deployee sur leurs postes (client riche). 

Dans le cas ou l'acteur serait un systeme externe (BarkBank ou PetEx), il 
n'y a pas d'interfaces graphiques. Les systemes communiquent entre eux 
en echangeant des donnees dans un format pivot. 
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Retour d'experience Qui redige les cas d'utilisation ? 



Les cas d'utilisation relatent les besoins des utilisateurs. II est done normal 
que ce soit eux qui les redigent. Malheureusement, ce n'est pas toujours 
le cas. En effet, meme si les utilisateurs connaissent bien leur metier, ils 
ont bien souvent tendance a ecrire tres voire trop peu, persuades que les 
analystes comprendront. Ainsi, la phrase anodine « Une fois les achats 
effectues, on obtient un bon de commande » peut susciter plusieurs inter- 
rogations, et notamment « Qu'est ce qu'un bon de commande ? », « Y a- 
t-il des contraintes legales pour certains produits ? », « Que fait-on du 
bon de commande ? »... II est alors frequent de rediger les cas d'utilisa- 
tion de maniere bidirectionnelle, sur la base d'interviews et d'entretiens 
de recueil du besoin. Ainsi, un analyste posera des questions par ecrit ou a 
I'oral a un utilisateur. Ce dernier y repondra, permettant ainsi a I'analyste 
de dresser les differents cas d'utilisation. 

Gerer les clients 

Resume 

Permet a un employe de creer/modifier/supprimer/rechercher/visualiser 
un client. 

Acteurs 

Employe. 

Description 

La societe YAPS veut pouvoir creer ses clients dans le systeme a partir 
des donnees existantes. Elle souhaite egalement pouvoir les modifier, les 
supprimer et les rechercher. Les elements caracterisant un client sont les 
suivants : 

• identifiant unique du client Q © ; 

• login 0 © et mot de passe © utilises par le client pour se connecter a 
l'application ; 

• prenom © et nom de famille © ; 

• numero de telephone ou Ton peut joindre le client et son adresse 
mail ; 

• adresse postale : deux zones permettent de saisir l'adresse du client. 
La premiere est obligatoire ©, la deuxieme optionnelle ; 

• pays de residence ©, ville ©, etat et code postal © ; 

• date de naissance : YAPS veut pouvoir envoyer des cartes de vceux a 
la date d'anniversaire du client ; 

• age du client. 

Une fois les donnees saisies, l'employe souhaite pouvoir les exploiter. 
Ainsi, a partir d'un identifiant, le systeme doit donner la possibilite 



UML Les exceptions 
dans les cas ({'utilisation 



Un cas d'utilisation decrit le comportement normal 
de I'application. Si des exceptions apparaissent, 
elles peuvent etre referencees dans la description 
a I'aide de numeros Q, Q... Dans notre cas, il 
faut lire ces exceptions de la maniere suivante : 
« le client a un identifiant unique, Q si cette 
valeur n'est pas unique, une exception est levee ; 
Q si cette valeur n'est pas renseignee alors 
qu'elle est obligatoire, une exception est levee ». 



d'afficher les coordonnees du client et proposer a l'employe de les mettre 
a jour ou de les supprimer. Dans le cas de la suppression, le systeme doit 
attendre une confirmation de l'employe avant de supprimer definitive- 
ment le client du systeme. 

Le systeme doit aussi pouvoir afficher la totalite des clients presents dans 
le systeme. 

Exceptions 

O Valeur unique. Si cette donnee existe deja dans le systeme, une excep- 
tion doit etre levee. 

© Donnee obligatoire. Si cette donnee est manquante, une exception 
doit etre levee. 



Retour d'experience Les maquettes 

Les maquettes d'ecrans facilitent la comprehen- 
sion des cas d'utilisation. Souvent non informati- 
ciens, les utilisateurs se reperent facilement grace 
a ce moyen visuel et peuvent enteriner les choix 
emis par I'analyste. 



Figure 1-2 

Application riche de gestion des clients 



Maquettes 

Les employes de la societe YAPS utilisent une application riche pour dialo- 
guer avec le systeme. Pour la gestion des clients, ils utilisent un ecran qui 
leur affiche la liste de tous les clients (menu List customers). Ils peuvent 
ensuite consulter les informations en cliquant sur le bouton View ou sup- 
primer le client en cliquant sur Delete. Un autre menu (Manage customer) 
permet de manipuler les informations d'un client, c'est-a-dire la creation, 
mise a jour, suppression et recherche a partir de son identifiant (figure 1-2). 
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Gerer le catalogue 



Resume 

Permet a un employe de creer/modifier/supprimer/rechercher/visualiser 
le catalogue des articles. 

Acteurs 

Employe. 

Description 

Le catalogue d'articles de la societe YAPS est divise en categories. Bien 
quelle envisage d'etendre sa gamme, YAPS ne vend actuellement que 
cinq categories d'animaux : poissons, chiens, chats, reptiles et oiseaux. 
Une categorie est definie par les donnees suivantes : 

• identifiant unique de la categorie Q 0 ; 

• nom (exemple : Poisson, Chien, Chat...) 0 ; 

• description (exemple : un chien est un animal affectueux qui parta- 
gera avec vous des moments de bonheur) 0. 

Chacune de ces categories est divisee en produits. Par exemple pour les 
chiens, on peut avoir les produits suivants : bulldog, caniche, dalmatien, 
labrador, levrier. Chaque produit est defini comme suit : 

• identifiant unique du produit Q 0 ; 

• nom (exemple : Bulldog, Caniche, Dalmatien...) 0 ; 

• description (exemple : un caniche est un petit chien affectueux qui ne 
prendra pas trop de place et saura vous reconforter par sa tendresse) 0. 

Enfin, chaque produit est, a son tour, divise en articles. Ce sont ces arti- 
cles qui sont proposes et vendus aux clients. Par exemple, le produit 
Caniche regroupe les articles suivants : caniche femelle adulte, caniche 
male adulte, caniche femelle 3 mois, caniche male 3 mois. Chaque 
article est defini comme suit : 

• identifiant unique de l'article Q 0 ; 

• nom (exemple : Caniche 3 mois femelle...) 0 ; 

• prix unitaire de l'article 0 ; 

• image : donne une representation graphique de l'article en question. 
Exceptions 

O Valeur unique. Si cette donnee existe deja dans le systeme, une excep- 
tion doit etre levee. 

0 Donnee obligatoire. Si cette donnee est manquante, une exception 
doit etre levee. 



UML Granularite des cas d'utilisation 

L'une des difficultes de la modelisation des cas 
d'utilisation consiste a trouver la bonne granula- 
rite. Un cas d'utilisation de trop grande taille 
signifie souvent qu'il peut etre decoupe en sous- 
cas, alors que de nombreux cas d'utilisation de 
petite taille peuvent etre regroupes en un seul. Le 
cas « Gerer le catalogue » decrit de maniere suffi- 
sante ce dont la societe YAPS a besoin pour gerer 
son catalogue. Dans notre cas, il serait done inutile 
et contre-productif d'avoir les cas d'utilisation 
« Creer une categorie », « Mettre a jour une 
categorie », « Supprimer une categorie », « Creer 
un produit »... 



Maquettes 

L'application cliente riche de l'employe permet de gerer tous les elements 
du catalogue, c'est-a-dire les categories, les produits et les articles. Ci-apres, 
les ecrans permettant d'afficher la totalite du catalogue ainsi que de mani- 
puler individuellement chacun des elements le composant (figure 1-3). 
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3 
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Figure 1-3 Application riche de gestion du catalogue 



Visualiser les articles du catalogue 

Resume 

Permet de visualiser le contenu du catalogue d'animaux domestiques. 
Acteurs 

Internaute, client. 
Description 

Les internautes et les clients peuvent visualiser la totalite du catalogue 
des animaux domestiques. L'organisation de l'affichage doit etre intui- 



tive, c'est-a-dire que le systeme doit afficher la liste des categories, a 
partir desquelles le client choisit un produit puis un article. 

Pour chaque article, une image representant l'animal devra etre affichee. 

A tout moment, il doit etre possible d'afficher les produits d'une cate- 
gorie differente. 



Diagramme d'activites 

Le diagramme d'activites ci-apres nous donne la representation gra- 
phique des actions effectuees pour visualiser le contenu du catalogue. II 
doit etre lu de la maniere suivante : « Le systeme affiche les categories du 
catalogue (chien, chat, poisson...). Lorsque l'internaute en selectionne 
une, le systeme affiche les produits de la categorie (bulldog, caniche...). 
Lorsqu'un produit est selectionne, le systeme affiche les differents arti- 
cles (bulldog femelle, caniche adulte...). Notez qua tout moment on 
peut revenir a Taction - Afficher les produits de la categorie ». 




electionne une categorie 



Afficher les produrts de la categorie ^ 




ilL Diagramme d'activites 



UML permet de representer graphiquement le 
comportement d'une methode ou le deroulement 
d'un cas d'utilisation, a I'aide de diagrammes 
d'activites. Ce type de diagramme est utilise pour 
representer les aspects dynamiques d'un systeme 
a un niveau assez general. II est compose d'un 
nceud initial (represents par un point noir), d'acti- 
vites liees entre elles par des evenements, puis se 
termine par un nceud final (un rond noir entoure). 



Selectionne une categorie 



Figure 1-4 

Diagramme d'activites de la visualisation 
des articles du catalogue 



Maquettes 

Les internautes et les clients visualisent le contenu du catalogue a partir 
de leur navigateur. Sur la colonne de gauche sont affichees les cinq cate- 
gories d'animaux domestiques vendus par la societe YAPS. En cliquant 
sur la categorie Dogs (chiens), l'internaute est redirige vers une page qui 
affiche les produits de cette categorie. Pour chaque produit, on affiche 
son nom et sa description (figure 1-5). 

En cliquant sur le produit Bulldog, l'internaute est redirige vers la liste des 
articles. Dans l'exemple ci-apres, ce produit possede deux articles : un 
male et une femelle. Pour chaque article, on affiche son nom et son prix 
(figure 1-6). 
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Figure 1-5 

Affichage de tous les produits 
de la categorie Dogs 
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Products for category : Dogs 
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The YAPS Pet Store Demo fs a 
fictional sample application. 
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Figure 1-6 

Affichage de tous les articles 
du produit Bulldog 
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YAPS Pet Store 
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Items for product : Bulldog 
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The YAPS Pet store Demo is a 
fictional sample application. 



S»q Derby 



Enfin, pour connaitre le detail d'un article, il suffit de cliquer sur son 
nom pour arriver sur la page de description. Le nom et le prix de l'article 
sont affiches ainsi que l'image representant l'animal (figure 1-7). 
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The YAPS P&t store cemo is a 
fictional sample application. 



Figure 1-7 

Affichage du detail d'un article 



Rechercher un article 

Resume 

Permet de rechercher un article par son nom ou le nom de son produit. 
Acteurs 

Internaute, client. 
Description 

En plus de visualiser le catalogue de maniere lineaire (voir cas d'utilisa- 
tion « Visualiser les articles du catalogue »), les internautes et les clients 
peuvent rechercher les animaux domestiques contenus dans le systeme a 
partir d'une chaine de caracteres. 

Par exemple, si la chaine de caracteres saisie est « iche » le systeme 
retournera les articles suivants : 



Nom de I'article 


Nom du produit 


Caniche nain male adulte 


Caniche 


Femelle 3 mois 


Caniche 


Plus petit qu'un caniche 


Chihuahua 



avaxhome.ws 
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La recherche ne tient pas compte des minuscules ou majuscules. Si 
aucun article ne correspond aux criteres demandes, une information est 
affichee a l'internaute pour lui indiquer que sa recherche n'a pas abouti et 
qu'il doit modifier le critere de recherche. 

Maquettes 

Pour rechercher les articles, l'internaute utilise la zone de saisie situee dans 
l'en-tete de toutes les pages du site. Cette zone est suivie d'un bouton 
Search. Lorsque l'internaute clique sur ce bouton apres avoir saisi un texte, le 
systeme retourne la liste des articles qui repondent au critere. Par exemple, 
ci-apres, la liste des articles repondant au critere adult (figure 1-8). 



Figure 1-8 

Liste des articles repondant 
au critere de recherche 
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The ws Pet store Demo Is a 
fictional sample application. 




Se creer un compte 

Resume 

Permet a un internaute de se creer un compte dans le systeme et de 
devenir ainsi un client. 

Acteurs 

Internaute. 



Description 

Ce cas d'utilisation differe du cas « Gerer les clients » dans le sens ou 
l'internaute ne peut renseigner que ses propres donnees. Pour se creer un 
compte, l'internaute doit saisir un login Q, un mot de passe et ressaisir 
une seconde fois son mot de passe Q. Le systeme lui demande alors de 
saisir ses coordonnees et informations personnelles (identiques a celles 
du cas d'utilisation « Gerer les clients »). 

Exceptions 

O Le login doit etre unique dans le systeme. Si ce nest pas le cas, 
l'internaute doit en etre averti et doit en choisir un autre. 

0 Si les deux mots de passe ne sont pas identiques, une exception doit 
etre levee. 

Post-conditions 

L'internaute est connu du systeme, il devient client de la societe YAPS. 



UML Post-conditions des cas d'utilisation 

Les post-conditions represented I'etat (les resul- 
tats) du cas d'utilisation a la fin de son execution. 
Si le cas d'utilisation « Se creer un compte » se 
deroule normalement, l'internaute devient un 
client de la societe YAPS. 



Maquettes 

Pour se creer un compte, l'internaute clique sur le menu Sign on, puis 
saisit un login unique suivi de deux fois son mot de passe. Apres verifica- 
tion de la validite des mots de passe et de leur concordance, le systeme 
lui demande de completer ses informations (figures 1-9 et 1-10). 



Rchcr Edition AlHthoqo Afcto Matqycooqcs Ojtib ' 
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YAPS Pet Store 

Yet Another Pet Store 



Birds 
Cats 
Dogs 

Flih 

Reptiles 



adult 
man on 



Sign In 



Yes. 
Login : j 
Password: 

[ Sign In ) 



like to sign up for an account. 
Login: jdiiiwt. 



PfrSSWOrd (Repent): \ m '* mm 
CrudLb r i >j ^ufjunL 



7T» YAPS P&t Store Demo is a 
fictional sample application. 



.'""t'tp » 



Figure 1-9 

Le client saisit son login 

et deux fois son mot de passe. 
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Figure 1-10 

Saisie des informations du client 



fichef e«»ti Afhchago Afcfi Mwcws p*3»s Cv*k > 



YAPS Pet Store 




UML Pre-conditions des cas d'utilisation 

Pour executer un cas d'utilisation, les pre-condi- 
tions doivent etre remplies. Dans I'exemple du cas 
d'utilisation « Se connecter et se deconnecter », le 
client doit auparavant s'etre cree un compte pour 
pouvoir se connecter a I'application. 



Se connecter et se deconnecter 

Resume 

Permet a un client de se connecter et de se deconnecter du systeme. 

Acteurs 

Client. 

Pre-conditions 

Le client s'est auparavant cree un compte (cas d'utilisation « Se creer un 
compte »). 

Description 

Le client saisit son login et son mot de passe Q ©. II est reconnu par le 
systeme, qui affiche alors son nom et prenom. Lorsque le client se 
deconnecte, il redevient internaute jusqu'a sa prochaine connexion. 

Exceptions 

O Si le login nest pas connu du systeme, une exception doit etre levee. 
© Si le mot de passe nest pas le bon, une exception doit etre levee. 
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Maquettes 

En cliquant sur le lien Sign on, l'internaute est redirige vers une page lui 
demandant de s'authentifier (figure 1-11). Apres avoir saisi son identi- 
fiant et son mot de passe, il est dirige vers la page d'accueil. 



' '• YAPS PelSlere Si e n In McuilU Finfo* 
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Password: ""1 
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Java <Ttl 



Figure 1-11 

Saisie du login et du mot de passe 
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Figure 1-12 

La page d'accueil affiche 
le nom et prenom du client. 



Cette fois, la page d'accueil affiche le nom et prenom du client, ainsi que 
trois liens lui permettant de se deconnecter (Sign Off), de consulter ses 
informations (/Account) et de visualiser le contenu de son panier electro- 
nique (Cart) (figure 1-12). 



Consulter et modifier son compte 

Resume 

Permet a un client de consulter et de mettre a jour ses informations per- 
sonnelles dans le systeme. 

Acteurs 

Client. 

Pre-conditions 

Le client doit etre connecte au systeme (cas d'utilisation « Se connecter 
et se deconnecter »). 

Description 

Ce cas d'utilisation differe du cas « Gerer les clients » dans le sens ou le 
client ne peut consulter et modifier que ses donnees personnelles. 
Celles-ci sont identiques a celles du cas d'utilisation « Gerer les clients ». 



Figure 1-13 

Les coordonnees du client 
s'affichent en lecture seule. 
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Your Account Information 











Firsuidine : 




lams 


1 surname : 




Rnnssnn 


Lmail : 




jrefimymail.com 


Telephone : 




02151 251 117 


DdLe ui birlr. (dd.MM.yyyy). 24.12,1968 


Atjr : 




37 



SUeeLl : RiUierduri Rudd 
rihnRRT? : 

City : Now York 
State : 

ZiptuUe : 4568 
c-nunfTf : USA 



edit >to Iniumttivn 



Maquettes 

Une fois connecte, le client peut consulter ses informations en cliquant 
sur le lien Account. Cette page de consultation affiche, en lecture seule, 
les informations du client. II peut ensuite les modifier en cliquant sur le 
lien Edit your account information (figures 1-13 et 1-14). 



IS} YAPS PctStorc Create Customer Mozilla Firefox 



BcNci edition Alhchogc Altoo Horouc doom Outils 2 
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Yet Another Pet Store 


| | Sun* | 
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Cats 
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rish 

Reptiles 



Update Your Account 




•strcotl : RiUiwtJuii RudU 
streets : High Wycombe 
•tin : |NewYork | 
stato : | | 
♦■iiocode : -1568 

•Country : |USfl | 



Figure 1-14 

Le client peut mettre a jour ses coordonnees. 



Acheter des articles 

Resume 

Permet a un client d'acheter des articles. 

Acteurs 

Client. 

Pre-conditions 

Le client doit etre connecte au systeme (cas d'utilisation « Se connecter 
et se deconnecter »). 

Description 

Un client visualise le catalogue (voir cas d'utilisation « Visualiser les arti- 
cles du catalogue ») ou recherche un animal domestique (voir cas d'utili- 
sation « Rechercher un article »). Lorsqu'il est interesse par un article, il 
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lui suffit de cliquer sur un lien pour aj outer cet article dans son panier 
electro nique (Caddie). Cette operation peut etre executee plusieurs fois 
sur des articles differents. Le client a ensuite la possibilite de modifier la 
quantite desiree pour chaque article ou supprimer un ou plusieurs de ces 
articles du panier. Lorsque la quantite d'un article est egale (ou infe- 
rieure) a zero, l'article est automatiquement supprime du panier. 

Pendant toute la duree de sa session, le client peut visualiser le contenu 
de son panier quand bon lui semble. Lorsque le Caddie est vide, un mes- 
sage avertit le client. Sinon, le systeme affiche la liste des articles avec le 
nom, la description du produit, la quantite desiree, le prix unitaire et le 
sous-total (prix unitaire x quantite). Le montant total du panier est ega- 
lement renseigne. Ce Caddie est illimite en taille, un client peut done 
acheter autant d'articles qu'il le souhaite. 

Lorsque le client est satisfait, il valide son panier electronique. II doit 
alors saisir les informations de sa carte bancaire ainsi que l'adresse de 
livraison. Par defaut, l'adresse de livraison est la meme que celle du client 
mais elle peut etre modifiee. Les donnees de la carte bancaire sont les 
suivantes : 

• Numero de carte bancaire. 

• Type de carte bancaire (Visa, Master Card et American Express). 

• Date d'expiration de la carte bancaire. Le format de cette date est 
MM/AA, e'est-a-dire deux chiffres pour le mois et deux pour 
l'annee, separes par le caractere /. 

Une fois toutes ces donnees validees Q, un bon de commande est cree. 
Le panier electronique est alors automatiquement vide. 

Exceptions 

O Les donnees de la carte bancaire sont validees par BarkBank. Si la 
banque rejette la carte bancaire, le client en est averti et peut ressaisir ses 
donnees. 

Post-condition 

Executer le cas d'utilisation « Creer un bon de commande ». 

Maquettes 

Lorsque l'internaute s'authentifie, le menu Cart apparait en haut de la 
page. Ce lien permet d'afficher le contenu du panier electronique. Si ce 
dernier est vide, la page affiche un message avertissant le client : The 
shopping Cart is empty (figure 1-15). 

Pour remplir le panier, il suffit de se rendre sur la page de description des 
articles et de cliquer sur le lien Add to cart. Cette action ajoute dans le 
Caddie l'article selectionne avec une quantite egale a un (figure 1-16). 
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Figure 1-15 

Le panier electronique est vide. 
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Figure 1-16 

Le client ajoute des articles 
en cliquant sur Add to cart. 



www.avaxhome.ws 
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Apres avoir effectue differents achats, le client clique sur le lien Cart pour 
consulter le contenu de son panier electronique. Cette page affiche le 
nom des articles achetes ainsi que leur quantite et leur prix. Le client 
peut a tout moment modifier la quantite de chaque article en cliquant 
sur Update ou supprimer un article en cliquant sur Remove. En bas du 
tableau s'affiche le montant total du panier electronique (figure 1-17). 



Figure 1-17 

Contenu du panier electronique 
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Une fois les achats termines, le client clique sur le lien Check out. Cette 
action l'amene sur une page lui demandant de saisir l'adresse de livraison 
et les coordonnees de sa carte bancaire (figure 1-18). 

Le client valide la page en cliquant sur Submit. II est alors redirige vers 
une page qui lui confirme la creation de sa commande et lui en donne le 
numero ainsi que son recapitulatif (figure 1-19). 
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Figure 1-18 

Saisie de I'adresse de livraison 
et du mode de paiement 
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Figure 1-19 

Confirmation de la creation 
du bon de commande 
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Creer un bon de commande 

Resume 

Une fois le panier electronique valide par le client, un bon de commande 
est cree. 

Acteurs 
Client. 

Pre-conditions 

Le client achete des articles et valide son panier electronique (voir cas 
d'utilisation « Acheter des articles »). 

Description 

Lorsque le panier electronique du client est valide, le systeme cree auto- 
matiquement un bon de commande. Ce dernier contient toutes les 
informations necessaires pour etre traite : 

• un numero de bon de commande ; 

• la date de creation de ce bon de commande ; 

• les references du client qui a achete les articles ; 

• les lignes de commande : une ligne de commande reference l'article 
achete et sa quantite. II y a autant de lignes de commande que d'arti- 
cles contenus dans le panier electronique ; 

• les informations de la carte bancaire ; 

• l'adresse de livraison des animaux. 

Cette creation du bon de commande entraine plusieurs traitements : 

1 Le bon de commande est imprime puis stocke dans les archives de la 
societe YAPS. 

2 Toutes les informations necessaires a l'acheminement des animaux 
sont envoyees au transporteur PetEx de maniere electronique au 
format XML. PetEx livre ensuite les animaux aux nouveaux heureux 
proprietaires. 

3 Un e-mail est envoye au client pour l'informer du bon deroulement 
de sa transaction. Cet e-mail contient le numero du bon de com- 
mande ainsi qu'un recapitulatif de son contenu. 

4 Pour des raisons legales, les employes doivent etre avertis des bons de 
commande contenant des reptiles (une alerte s'affiche dans l'interface 
graphique de l'employe). 

Visualiser et supprimer les commandes 

Resume 

Permet a un employe de visualiser et de supprimer les commandes pre- 
sentes dans le systeme. 



Acteurs 



Employe. 
Description 

Lemploye peut visualiser la liste des commandes presentes dans le sys- 
teme. Pour chacune de ces commandes, il peut en consulter les informa- 
tions et les supprimer. 

Pour des raisons legates, les employes de YAPS veulent etre avertis en temps 
reel des achats de reptiles. Selon les pays, il faut en effet avertir les autorites. 
Ainsi, des qu'une commande contenant des reptiles est passee, les employes 
en sont avertis par une alerte qui s'affiche dans l'interface graphique. 

Maquettes 
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Figure 1-20 

Application client riche 

de la gestion des bons de commande 



En resume 

Dans ce chapitre, nous avons presente l'etude de cas de 1' application 
YAPS Pet Store ainsi que les acteurs qui l'utilisent. Le diagramme de cas 
d'utilisation nous a permis de formaliser les besoins de maniere synthe- 
tique, puis d'expliciter chaque cas d'utilisation de maniere textuelle. Les 
diagrammes d'activites et les maquettes d'ecrans sont venus eclaircir la 
dynamique de certains cas d'utilisation. Cette application sera concue et 
realisee au cours des prochains chapitres. 



chapitre 





Architecture de I'appl ication 



Dans le precedent chapitre, nous avons decrit le comportement 
souhaite de la future application de commerce electronique 
de la societe YAPS. Vous allez maintenant decouvrir 
les technologies utilisees pour developper cette application, 
c'est-a-dire le langage Java et la nouvelle plate-forme Java EE 5. 
Grace a l'utilisation de diagrammes UML de composants et 
de deploiement, nous allons modeliser et decrire l'architecture 
logicielle de l'application YAPS Pet Store. Celle-ci s'inspire 
du Blueprint Java Pet Store de Sun et de ses design patterns. 
Elle est architecturee en couches (presentation, traitements 
et acces aux donnees) et utilise la plate-forme Java EE 5 
qui s'appuie sur les nouveautes du langage Java 5 (annotations, 
generiques...). 



SOMMAIRE 
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Presentation des langages utilises 



API 



Une API, ou Application Programming Inter- 
face, definit la maniere dont un composant infor- 
matique peut etre invoque par un autre. II s'agit 
generalement d'une liste de methodes que Ton 
peut appeler. 



Java SE 5 

Avant de parler de Java Enterprise Edition 5 (Java EE 5), il est necessaire 
de presenter brievement le langage sur lequel s'appuie cette plate-forme : 
Java 5.0. La version 5 de Java SE, ou Java Standard Edition, est une revi- 
sion majeure du langage Java cree en 1995 par l'equipe de James Gosling. 
Cette version apporte de nombreuses nouveautes telles que l'autoboxing, 
les annotations, les generiques, une nouvelle boucle d'iteration, les types 
enumeres, les methodes a arguments variables, les imports statiques et 
bien d'autres encore. De nouveaux outils ainsi que de nouvelles API ont vu 
le jour ou ont ete considerablement enrichis, comme 1API de concur- 
rence, 1API de thread, la supervision de la JVM, etc. 



A LIRE Java 5 




II existe beaucoup de livres sur le langage Java 


Outils et 


ainsi que de nombreuses references et articles en 


API d'outils 


ligne, notamment : 


Technologies 


£0 Emmanuel Puybaret, Java 1.4 et 5.0, 


de deploiement 


Eyrolles, 2006 


Interface 


£0 Claude Delannoy, Programmer en Java, 


graphique 


Eyrolles, 2007 


Librairies 


CD Anne Tasso, Le livre de Java premier 


d'integration 


langage, Eyrolles, 2006 


► http://java.sun.com/docs/books/jls/ 
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Java 5 Les technologies 



Vous retrouverez sur le site de Sun la liste des 
outils, API et librairies que contient Java 5 : 
► http://java.sun.com/javase/technologies/ 
index.jsp 



La figure 2-1 montre les composants qui constituent Java SE 5. Cet 
ouvrage n'a pas la pretention de vous expliquer toutes les nouveautes du 
langage. Toutefois, il est important de s'attarder sur celles qui seront uti- 
lisees tout au long de notre etude de cas. La suite de cette partie tend a 
presenter succinctement les elements caracteristiques de Java SE 5 aux- 
quels nous allons nous confronter. 



Autoboxing 

Le langage Java s'appuie sur des types primitifs pour decrire les types de 
base (byte, short, int, long, double, float, boolean et char). Toutefois, 
comme tout n'est qu'objet en Java, il est necessaire de constamment 
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encapsuler ces types primitifs dans des classes de reference (integer pour 
int, Double pour double, etc.). 

Ce type de transformation (appele boxing) peut rapidement s'averer 
penible. D'autant que le processus inverse (appele unboxing) est neces- 
saire pour retrouver son type primitif initial. Avec Java 5, cette conver- 
sion explicite devient obsolete puisque l'autoboxing convertit de maniere 
transparente les types de base en references et reciproquement. Bien sur, 
vous pouvez continuer a utiliser uniquement les types primitifs si vous le 
souhaitez. 



Java 5 JConsole 



La JConsole est un utilitaire de surveillance fourni 
avec Java SE 5. Liee aux technologies JMX et 
MBean, la JConsole permet de surveiller et super- 
viser les applications Java (occupation memoire, 
threads en cours, classes chargees...) tout comme 
de prendre en charge certaines operations 
(appeller le garbage collector, changer le niveau 
des logs, etc.). 



Exemple d'autoboxing 

// Boxing explicite entre un Integer et un int 
Integer objet = new Integer(5); 
int primitif = objet . intVal ue() ; 

// Autoboxing 
Integer objet = 5; 
int primitif = objet; 



Annotations 



Une annotation permet de marquer (on dit alors annoter) certains ele- 
ments du langage Java afin de leur ajouter une propriete particuliere. Ces 
annotations peuvent ensuite etre utilisees a la compilation ou a l'execu- 
tion pour automatiser certaines taches. Une annotation peut etre utilisee 
sur plusieurs types d'elements (paquetage, classe, interface, enumeration, 
annotation, constructeur, methode, parametre, attribut de classe ou 
variable locale). 

Exemple d'utilisation d'annotations 

©CeciEstUneAnnotationSurUneClasse 

public class MaClasse { 

©UneAnnotationSurUnAttribut 

private Date unAttribut; 

OSurUneMethode 

private void maMethode() { 
return ; 

} 

} 

Comme vous le verrez tout au long de cet ouvrage, 
Java Enterprise Edition 5 utilise tres frequemment les annotations. 
Nous aurons l'occasion de nous y attarder plus longuement par la suite. 



Information Acronymes 



La plate-forme Java est extremement riche. Elle a 
done tendance a utiliser abondamment et a abuser 
d'acronymes en tout genre (souvent commencant 
par la lettre « J »). Vous trouverez en annexe un 
lexique d'acronymes et de sigles. 



avaxhome.ws 
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APPROFONDIR Annotations et generiques 

Si vous voulez en savoir plus sur les annotations et 
les generiques, consultez le tutoriel de Sun. Vous y 
trouverez une information mise a jour ainsi que 
des exemples de code. 

► http://java.sun.com/docs/books/tutorial 



APPROFONDIR Les types enumeres 

Les types enumeres offrent d'autres possibility : 
iteration, utilisation dans un swi tch, EnumSet, 
EnumMap, etc. Pour en savoir d'avantage, con- 
sultez le site de Sun a I'adresse : 
► http://java.sun.eom/j2se/1.5.0/docs/guide/ 
language/enums.html 



Rappel Perimetre de ce livre 

Ce livre n'a pas la pretention de vous enseigner les 
nouveautes du langage Java mais uniquement de 
vous presenter celles qui vont etre utilisees lors de 
la realisation de I'application YAPS Pet Store. Si 
vous n'etes pas encore a I'aise avec les annota- 
tions, les generiques ou les types enumeres, 
reportez-vous aux references donnees dans cet 
ouvrage pour approfondir vos connaissances. 



Generiques 

Pour les personnes familieres des templates C++, les generiques sont 
simples a comprendre, meme si leur fonctionnement n'est pas du tout 
similaire. lis permettent de ne pas specifier le type a la compilation 
(parametre ou retour de methode, par exemple), tout en assurant que le 
type reste coherent dans ses differentes utilisations. II est par exemple 
possible de specifier qu'une collection (un objet Vector, Hashtable ou 
Array, par exemple) ne peut etre remplie que par un type de classe donne 
(Vector<Integer> pour declarer un vecteur d'entiers). II n'est done plus 
necessaire d'effectuer le controle du type au moment de l'execution. 

Exemple d'un vecteur generique 

// Sans generique 

Vector nombres = new VectorO; 

for (int i =0; i < nombres. si ze () ; i++) { 

Integer nombre = (Integer) nombres . el ementAt(i ) ; 

} 

// Avec generique 

Vector <Integer> nombres = new Vector<Integer>() ; 
for (int i =0; i < nombres . si ze() ; i++) { 
Integer nombre = nombres. el ementAt (i ) ; 

} 

Comme on peut le constater dans le fragment de code ci-dessus, le par- 
cours des elements du vecteur avec generique presente une meilleure lisi- 
bilite ainsi qu'une plus grande robustesse. 

Les types enumeres 

Java 5.0 introduit le nouveau mot-cle enum, utilisable comme le mot-cle 
class. Sa particularite est qu'il represente un type enumere, e'est-a-dire 
un type qui n'accepte qu'un ensemble fini d'elements. II peut done etre 
utilise pour definir un ensemble de constantes. 

Exemple d'une enumeration 

i public enum Saisons { 
PRINTEMPS, 
ETE, 

AUTOMNE , 
HIVER 

}; 
Swing 

La plupart des applications destinees aux utilisateurs comportent des 
elements graphiques de telle sorte qu'elles soient plus conviviales et 
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ergonomiques. La plate-forme Java dispose des API AWT et Swing 
permettant de construire des interfaces homme-machine (IHM) sophis- 
tiquees en client lourd. 



File Customer Catalog Order Look&Feel 



Q Category 



Category 



Identifier 
Name 
Description |Any ofnur 



Fish 



Lis 



ID 


Name 


Description 


5 


Birds 


Any of the class Aves of warm-blooded, egg-laying, fe 


4 


Cats 


Small carnivorous mammal domesticated since ear... 


2 


Dog* 


A domesticated carnivorous mammal related to the f 


1 


Fish 


Any of numerous cold-blooded aquatic vertebrates c... 


3 


Reptiles 


Any of various cold-blooded, usually egg-laying verte... 



Update 



Swing 



Pour de plus amples informations, reportez-vous 
aux references suivantes : 
£Q Emmanuel Puybaret, Swing, Eyrolles, 2006 
CB Kathy Walrath, The JFC Swing Tutorial, 
Addison-Wesley, 2004 



Figure 2-2 

Application cliente developpee en Swing 



Swing sera utilise dans cet ouvrage pour developper une partie de l'inter- 
face utilisateur. Toutefois, cette bibliotheque tres riche, et parfois com- 
plexe, ne sera pas enseignee dans ce livre. 



Dans le chapitre 6, nous utiliserons JNDI pour 
acceder aux composants distants a partir de 
I'interface Swing. 



JNDI 1.5 

Ce composant, appele communement service de nommage, est un service 
fondamental dans n'importe quel systeme informatique. II permet 
d'associer des noms a des objets et de retrouver ces objets grace a leurs 
noms. Java Naming and Directory Interface (JNDI) fournit les fonction- 
nalites de nommage et d'annuaire aux applications ecrites en Java. 

Omnipresent dans la version J2EE 1.4, JNDI se fait plus discret et il est 
integre directement dans Java SE 5. II continue a etre une piece mai- 
tresse mais de maniere plus transparente. 

JDBC 3.0 

JDBC (Java Data Base Connectivity) est une API permettant l'acces a 
des bases de donnees relationnelles a partir du langage Java. Elle se 
charge de trois etapes indispensables a Faeces aux donnees : 

• la creation d'une connexion a la base ; 

• l'envoi d'instructions SQL ; 

• l'exploitation des resultats provenant de la base. 

Pour acceder a la base de donnees, JDBC s'appuie sur des drivers (pilotes) 
specifiques a un fournisseur de SGBDR ou sur des pilotes generiques. 



APPROFONDIR JNDI 



Java Naming and Directory Interface est 
rarement utilise seul. II est generalement employe 
avec les EJB. II n'y a done que peu de livres s'attar- 
dant uniquement sur cette API. 
Ill Rosanna Lee, The Jndi Api: Tutorial and 
Reference: Building Directory-Enabled 
Java Applications, Addison-Wesley, 2000 
► http://java.sun.com/products/jndi/ 



Persistans Les pilotes JDBC 

Les pilotes JDBC sont classes en quatre categories : 

• Les pilotes de type 1 (pont JDBC/0DBC) per- 
mettent de convertir les appels JDBC en appel 
ODBC {Open Database Connectivity), 

• Les pilotes de type 2 sont ecrits en code natif et 
dependent de la plate-forme. 

• Les pilotes de type 3 utilisent un autre pilote 
JDBC intermediate pour acceder a la base de 
donnees. 

• Les pilotes de type 4 sont ecrits entierement en 
Java, lis sont done portables. 
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//. Les balises 



Une balise est une portion de texte encadre par les 
caracteres < et >. Elle sert a delimiter des ensem- 
bles de donnees contenues dans un document afin 
de le structurer. XML est un langage de balisage. 



APPROFONDIR XML et XSD 

CO Alexandre Brillant, XML - Cours et 

exercices, Eyrolles, 2007 
CO Antoine Lonjon, Jean-Jacques Thomasson, 

Libera Maesano, Modelisation XML, 

Eyrolles, 2006 
CO Mitch Amiano, Conrad D'Cruz, Michael D. 

Thomas , Kay Ethier, XML, Wrox, 2006 

► http://www.w3.org/XML/ 

► http://www.w3.org/XML/Schema 



XML et XSD 

SGML {Standard Generalized Markup Language, ou langage normalise 
de balisage generalise), adopte comme standard en 1986, a ete la pre- 
miere tentative pour creer des documents electroniques. L'idee princi- 
pale etait de separer le contenu d'un document de sa forme. SGML a ete 
une innovation, mais d'une complexite telle que sa manipulation s'est 
trouvee restreinte aux specialistes. 

XML (extensible Markup Language, ou langage extensible de balisage), 
issu de SGML, a ete mis au point par le World Wide Web Consortium 
(W3C) en 1996. Contrairement a HTML, qui presente un jeu limite de 
balises orientees presentation (titre, paragraphe, image, lien hyper- 
texte. . .), XML est un metalangage, qui va permettre d'inventer a volonte 
de nouvelles balises pour decrire des donnees et non leur representation. 

XML permet done de definir des fichiers dont la structure est personna- 
lisee par la creation de balises. De fait, ce langage s'impose comme un 
standard dans les echanges inter-systemes d'information. XML devient 
un format pivot, qualifie encore de format d'echanges. De plus, un cer- 
tain nombre d'API offre des mecanismes pour creer, extraire et verifier la 
validite d'un document XML. Cette validation n'est possible que si Ton 
connait la structure du document. Cette structure est definie par un 
XML Schema Definition (XSD), technologie derivee d'XML. Un 
schema XML (XSD) est lui-meme un fichier XML. 



Exemple de document XML 

<raci ne> 

<titre nom=' exemple de message XML'/> 
<message> 

donnees envoyees entre emetteur et recepteur 
</message> 
</racine> 



APPROFONDIR HTML/XHTML 



CQ Mathieu Nebra, Reussir son site web avec 

XHTML et CSS, Eyrolles, 2008 
CQ Jean Engels, XHTML et CSS, Eyrolles, 2006 
CD Raphael Goetter, Memento XHTML, 

Eyrolles, 2006 
* http://www.w3.org/MarkUp/ 
► http://www.w3.org/TfVxhtml1/ 



HTML et XHTML 

A partir de 1992, Internet popularise le langage HTML [Hypertext 
Markup Language, ou langage de balisage hypertexte, concu vers 1990) 
pour la presentation de documents electroniques hypertextes. Issu de 
SGML, HTML definit un certain nombre de balises liees uniquement a 
la presentation. Depuis quelques annees, le HTML tend a etre remplace 
par le XHTML qui lui apporte la rigueur de la notation XML. 
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Exemple de page HTML 

<html> 
<head> 

<title>Page HTML affi chant Hello World</title> 
</head> 
<body> 

<center>Hel lo Worl d</center> 
</body> 
</html> 



La plate-forme Java EE 5 

Java EE, ou Java Enterprise Edition, est un ensemble de specifications 
destinees aux applications d'entreprise. Java EE peut etre vu comme une 
extension du langage Java afin de faciliter la creation d'applications 
reparties, robustes, performantes et a haute disponibilite. 

Comme beaucoup, je pense que Java EE est aujourd'hui la meilleure 
plate-forme de developpement pour les entreprises. Elle combine les 
avantages du langage Java avec l'experience acquise dans le developpe- 
ment au cours des dix dernieres annees. Elle beneficie en outre du dyna- 
misme des communautes Open Source ainsi que du JCP de Sun. 



Rappel Java EE 5 dans cet ouvrage 

La nouvelle plate-forme Java EE 5 comporte plus 
de vingt specifications (voir annexe A). II est 
impossible en un seul ouvrage de couvrir toute les 
particularity de ces specifications. Le developpe- 
ment de notre etude de cas nous permettra d'uti- 
liser les plus importantes et surtout de voir 
comment elles s'utilisent ou interagissent les unes 
par rapport aux autres. Pour approfondir vos con- 
naissances, n'hesitez pas a consulter les nom- 
breuses references contenues dans ce livre. 



Conteneur Web 



JSP 



Servlet 



CO 



SAAJ 



70 
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to 
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Java 
Mail 



JAF 



Java SE 
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EJB 
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Java 
Mail 
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Applet 



Java SE 



Java SE 




Figure 2-3 L'architecture de Java EE 5 
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A JCP 

Java Community Process est le processus utilise 
par Sun et de nombreux partenaires pour coor- 
donner revolution du langage Java et des techno- 
logies associees. 



Precision Conteneur client 

Le conteneur client, ou Application Client Con- 
tainer (ACC), apporte aux applications Java SE 
(par exemple, Swing) des services de securite, de 
nommage, d'injection... 



Precision J2EE, Java EE, J2SE, Java SE 

Pendant longtemps, Java et sa plate-forme entre- 
prise ont ete appeles respectivement J2SE et J2EE. 
Depuis la version 5, le chiffre « 2 » a disparu pour 
faciliter la comprehension de la version utilisee. Ce 
livre utilisera done les nouvelles appellations 
Java SE et Java EE. Le terme J2EE sera utilise pour 
designer I'ancienne specification. 



JPA, Java Persistence API, est presente au 
chapitre 4. Cette API est utilisee pour developper 
les objets metier de I'application YAPS Pet Store. 



A JSR 

JSR, ou Java Specification Requests, est un sys- 
teme normalise ayant pour but de faire evoluer la 
plate-forme Java en donnant la possibility a la 
communaute de creer de nouvelles specifications. 
Vous pouvez retrouver toutes les specifications sur 
le site du JCP. 
► http://www.jcp.org 



Bien que cette plate-forme soit predite a un bel avenir, ses promesses ne 
sont pas toujours honorees. Les systemes delivres sont souvent trop lents et 
compliques, et le temps de developpement est, quant a lui, frequemment 
disproportion^ par rapport a la complexite des demandes des utilisateurs. 

Heureusement, au deuxieme trimestre 2006, Java EE 5 est venu simpli- 
fier la precedente version (J2EE 1.4). S'appuyant sur la nouvelle mou- 
ture du langage Java et s'inspirant de frameworks Open Source, certains 
composants de la version 5 de Java EE ont ete totalement reecrits dans le 
but de simplifier la plate-forme. 

La figure 2-3 decrit les differents conteneurs specifies dans Java EE 5 
ainsi que les specifications qui peuvent y etre employees. Les paragra- 
phes suivants nous donnent un bref descriptif des specifications utilisees 
pour le developpement de I'application YAPS Pet Store. Certaines ont 
vu le jour avec la version 5 de Java EE, d'autres ont ete completement 
remaniees pour simplifier le travail des developpeurs. 

JPA 1.0 

Depuis les debuts de J2EE, le modele de persistance ne cesse d'evoluer 
et de s'engluer de version en version. Les entity beans 2.0 ont ete com- 
pletement rearchitectures pour laisser place aux entity beans 2.1. Bien 
que cette evolution ait apporte beaucoup d'ameliorations, ce modele de 
composants persistants continuait a faire des detracteurs parmi la com- 
munaute. Ce mecontentement a donne naissance a une nouvelle specifi- 
cation (JDO, Java Data Object) ainsi qua differents outils de mapping 
objet/relationnel payants ou libres (TopLink, Hibernate...). 

Java EE 5, avec son lot de nouveautes, nous apporte un nouveau modele 
de persistance : JPA (Java Persistence API). Fortement inspires par des 
outils Open Source tels qu'Hibernate ou par JDO, le mapping objet/ 
relationnel et le langage de requete sont totalement differents de 
l'ancetre entity bean 2.1. JPA, ou JSR-220, reconcilie ainsi les utilisa- 
teurs de la plate-forme Java EE avec les composants persistants. 

Java Persistent API s'appuie sur JDBC (Java Data Base Connectivity) 
pour communiquer avec la base de donnees. En revanche, grace a l'abs- 
traction apportee par JPA, nous n'aurons nul besoin d'utiliser directe- 
ment JDBC dans le code Java. 

JMS 1.1 

Une des manieres d'avoir des traitements asynchrones en Java EE, con- 
siste en 1'utilisation d'un MOM (Message-Oriented Middleware), e'est-a- 
dire un systeme base sur l'echange de messages. En utilisant JMS (Java 
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Message Service), un client produit un message et le pub lie dans une file 
d'attente. Ainsi, la communication des evenements ou des donnees se 
fait de facon asynchrone : ni le client ni l'EJB ne dependent de la 
reponse directe de l'autre et leurs traitements ne sont done pas figes 
durant l'attente d'une reponse. 

EJB 3.0 

Les Entreprise Java Beans, ou EJB, sont des composants serveurs qui res- 
pectent les specifications d'un modele edite par Sun. Ces specifications 
definissent une architecture, un environnement d'execution (un conte- 
neur) et un ensemble d'API. Le respect de ces specifications permet 
d'utiliser les EJB independamment du conteneur dans lequel ils s'execu- 
tent. Ce dernier fournit un ensemble de fonctionnalites comme la ges- 
tion du cycle de vie de l'EJB, la securite, l'acces concurrent et les 
transactions. Le but des EJB est de faciliter la creation d'applications 
distribuees pour les entreprises. 

Piece maitresse de 1' architecture Java EE, les EJB 3 apportent des modi- 
fications notables dans le mode de developpement et integrent de nom- 
breuses nouveautes, notamment en ce qui concerne la persistance. Le 
passage des EJB 2.1 en 3.0 apporte une simplification radicale en sup- 
primant les descripteurs de deploiement, les appels JNDI, etc., et laisse 
place aux annotations. 

II existe deux grandes families d'EJB : entite et session. Les EJB sessions 
sont differencies entre EJB sans etat, avec etat ou s' executant en mode 
asynchrone. 



A LIRE JMS 



CO Richard Monson-Haefel, Java Message 

Service, O'Reilly, 2002 
EQ Eric Bruno, Java Messaging, Charles River 

Media, 2005 



A Serveur d'applications 

Un serveur d'applications heberge les applications 
destinees a etre utilisees dans un reseau distribue. 
II est dote de services transactionnels entre com- 
posants, d'equilibrage de charge ou encore de 
tolerance aux pannes. 



A LIRE EJB 



CO Laboratoire Supinfo, EJB 3 : des concepts 
a I'ecriture du code, Dunod, 2006 

£Q Rima Patel Sriganesh, Gerald Brose, Micah 
Silverman Mastering Enterprise 
JavaBeans, Wiley, 2006 



EJB stateless 

Les EJB sans etat, ou stateless session beans, ne fonctionnent que de facon 
ephemere. Une fois qu'un client a demande et recu une fonctionnalite du 
composant, l'interaction avec ce composant prend fin, ne laissant aucune 
trace de ce qui s'est passe. Ils n'ont aucune connaissance du client ou d'un 
semblant de contexte concernant l'enchainement des requetes : ils sont 
done parfaits pour une utilisation unique. Ils n'ont pas d'etat, e'est-a-dire 
qu'on ne peut pas manipuler leurs attributs en etant sur de leur valeur. 

Lutilisation standard d'un EJB sans etat reside dans le fait qu'une appli- 
cation cliente le contacte en lui transmettant des parametres. L'EJB 
accede alors a une base de donnees, effectue plusieurs traitements, 
appelle d'autres EJB, puis retransmet un resultat au client. Lorsque la 
communication s'acheve, le bean ne conserve aucun souvenir de l'inte- 
raction. Avec ce comportement, plusieurs clients distincts peuvent 
acceder simultanement a un meme stateless session bean. 



Le chapitre 5 presente les stateless session beans. 
Nous les utiliserons pour developper les compo- 
sants metiers. 
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Exemple d'EJB stateless 
©Stateless 

public class MonBean { 
// Le code metier 
public void maMethode() { 
return; 

} 

} 



EJB stateful 



EJB Avec ou sans etat ? 



Un EJB stateless est utile pour calculer cos(x), con- 
vener des euros en dollars, supprimer tous les bons 
de commandes passes il y a cinq ans ou obtenir le 
cours d'une action. 

Un EJB stateful sert a stacker des articles achetes 
en ligne dans un panier electronique ou a com- 
mander plusieurs billets de train. 



Le chapitre 8 presente les stateful session beans 
qui seront utilises pour developper le panier elec- 
tronique de I'application YAPS Pet Store. 



Par opposition au composant sans etat, les stateful session beans associent 
les requetes a un client specifique, unissant client et EJB dans une rela- 
tion un-un. Ce type de composant fournit ainsi un ensemble de traite- 
ments via des methodes, mais il a aussi la possibilite de conserver des 
donnees entre les differents appels de methodes d'un meme client. Une 
instance particuliere est done dediee a chaque client, qui sollicite ses ser- 
vices et ce, tout au long du dialogue. 

Les donnees conservees par le bean sont stockees dans les variables 
d'instances. Les donnees sont done conservees en memoire. Generale- 
ment, les methodes proposees par le composant permettent de consulter 
et de mettre a jour ces donnees. 

Exemple d'EJB stateful 

©Stateful 

public class MonBean { 

// Attribut conservant sa valeur 
private String monAttribut; 
// Le code metier 
public void maMethodeO { 
return; 

} 

} 



L'API JMS et les message-driven beans sont decrits 
au chapitre 10. Les traitements asynchrones de 
I'application utilisent ces deux technologies. 



Message-driven bean 

Les precedents types d'Enterprise Java Beans offrent des services de 
maniere synchrone. Le client emet une requete, puis attend que l'EJB lui 
envoie un resultat. 

Pour les message-driven beans (MDB), le comportement est complete- 
ment different. Les clients n'appellent pas directement des methodes 
mais utilisent JMS pour produire un message et le publier dans une file 
d'attente. A 1' autre bout, le MDB est a l'ecoute de cette file d'attente et 
se « reveille » a l'arrivee d'un message. II extrait ce dernier de la file 
d'attente, en recupere le contenu puis execute un traitement. Le client 
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n'a done pas besoin de figer son execution durant le traitement du 
MDB. Le traitement est asynchrone. 

Exemple de MDB 

©MessageDriven 

public class MonMDB implements MessageListener { 

public void onMessage (Message msg) { 
// Traiter le message 

} 

} 

Entity 

Les stateful session beans sont detruits lorsque la session du client se ter- 
mine. lis ne peuvent done pas etre utilises pour stocker de facon perma- 
nente les informations de l'application. Les EJB entites peuvent repondre 
a ce besoin puisqu'ils sont persistants. En effet, leur etat est sauvegarde 
sur un support de stockage externe, comme une base de donnees. Les 
entities representent des donnees, ou plus exactement des objets metier, 
qui perdurent apres la fin d'une session. lis existent souvent sous la forme 
d'enregistrements uniques dans une base de donnees. 

Depuis Java EE 5 et l'arrivee de JPA, on a plutot tendance a parler 
d'entite (entity) que de bean entite (entity bean). En effet, si les entity 
beans 2.1 ont un modele de developpement assez lourd et complique, les 
entities sont, eux, de simples classes Java (Pojo) et peuvent meme etre 
utilises en dehors de Java Enterprise Edition, e'est-a-dire dans une 
application Java standard. II faut juste se faire a l'idee qu'un entity bean 
est devenu une simple classe Java (lightweight) et non un composant 
lourd (heavyweight) et complexe a developper. 

Exemple d'entite d'adresse 

©Entity 

@Tab1e(name = "t_adresse") 
public class Adresse { 

@Id ©GeneratedVal ue 

private Long identifiant; 
private String rue; 

} 

Le conteneur d'EJB 

Souvent aussi appele a tort serveur d' applications, le conteneur d'EJB a la 
responsabilite de creer de nouvelles instances d'EJB et de gerer leur cycle 
de vie. II est l'intermediaire entre l'EJB et le serveur d'applications. II 



//. Pojo 

Pojo est un acronyme qui signifie Plain Old Java 
Object. Ce terme est principalement utilise pour 
faire reference a la simplicity d'utilisation d'un 
objet Java en comparaison avec la lourdeur d'utili- 
sation d'un composant EJB. 



Annotations Java EE 

Vous avez peut-etre remarque, dans les extraits de 
code precedents, I'utilisation des annotations Java 
dans le monde Java EE : ©Entity, 
©MessageDri ven, ©Stateless, 
©Stateful. Comme nous le verrons dans les 
chapitres suivants, il en existe bien plus encore. 
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A HTTP 

HTTP, ou Hypertext Transfer Protocol, est un 
protocole de transfert de pages HTML sur le Web. 
Sa fonction premiere est d'etablir la connexion 
avec un serveur, qui contient la page que Ton veut 
voir afficher, et de rapatrier cette page sur le poste 
de I'internaute. 



A LIRE ServletetJSP 

CO Jean-Luc Deleage, JSP et Servlets 

efficaces, Dunod, 2005 
£0 Francois-Xavier Sennesal, JSP avec Eclipse 

et Tomcat, ENI, 2007 
CD Anne Tasso, Sebastien Ermacore, 

Initiation a JSP, Eyrolles, 2004 



fournit des services tels que le transactionnel, la securite, la concurrence, 
la distribution, le service de nommage des EJB (JNDI) et 1' execution. 

Les EJB interagissent avec le conteneur de plusieurs manieres et peuvent 
executer des traitements declenches automatiquement par ce dernier. De 
meme que si un EJB leve une exception, celle-ci est tout d'abord inter- 
ceptee par le conteneur qui decidera d'effectuer telle ou telle action. 

Servlet 2.5 et JSP 2.1 

Les servlets sont des programmes Java fonctionnant cote serveur au 
meme titre que les CGI et les langages de script tels que ASP ou PHP. 
Les servlets permettent done de recevoir des requetes HTTP, de les 
traiter et de fournir une reponse dynamique au client. Elles s'executent 
dans un conteneur utilise pour etablir le lien entre la servlet et le serveur 
web. Les servlets etant des programmes Java, elles peuvent utiliser toutes 
les API Java afin de communiquer avec des applications externes, se 
connecter a des bases de donnees, acceder aux entrees-sorties (fichiers, 
par exemple) . . . 

Java Server Page, ou JSP, est une technologie basee sur Java qui permet 
aux developpeurs de generer dynamiquement du code HTML, XML ou 
tout autre type de page web. Une page JSP (reperable par l'extension 
. jsp) aura un contenu pouvant etre different selon certains parametres 
(des informations stockees dans une base de donnees, les preferences de 
l'utilisateur...) tandis qu'une page web « statique » (dont l'extension est 
.htm ou .html) affichera continuellement la meme information. 

Exemple de page JSP affichant la date du jour 

<%@ page import="java.uti"l .Date"%> 

<html> 
<head> 

<tit1e>JSP Affichant la date</tit1e> 
</head> 
<body> 

<%! Date today = new Date();%> 

<br/> 

<center>La date est <%= today %></center> 
</body> 
</htm"l> 

Une JSP est un autre moyen d'ecrire une servlet. Lorsqu'un utilisateur 
appelle une page JSP, le serveur web cree un code source Java a partir du 
script JSP (e'est-a-dire qu'il constitue une servlet a partir du script JSP), 
le compile, puis 1' execute. 
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Langage d'expression 

Le langage d'expression, ou Expression langage (EL), permet aux JSP 
d'acceder aux objets Java, de manipuler des collections ou d'executer des 
actions JSF. Une expression est de la forme suivante : 

| ${expression} 

Exemple de page JSP utilisant le langage d'expression 

<html> 
<body> 

<c:if test="${bean.attr < 3}" > 

<center>La date est ${bean . today}</center> 
</c : i f > 
</body> 
</html> 



JSTL 1.2 

JSTL est le sigle de JSP Standard Tag Library. C'est un ensemble de 
balises personnalisees (Custom Tag), developpees sous laJSR052 facili- 
tant la separation des roles entre le developpeur Java et le concepteur de 
pages web. L'avantage de ces balises est de deporter le code Java contenu 
dans la JSP dans des classes dediees. Ensuite, il suffit de les utiliser dans 
le code source de la JSP en utilisant des balises particulieres, tout comme 
vous le feriez avec des balises HTML classiques. 

Les bibliotheques de balises (Taglibs) ou balises personnalises (Custom 
Tag) permettent de definir ses propres balises basees sur XML, de les 
regrouper dans une bibliotheque et de les reutiliser dans des JSP. C'est 
une extension de la technologie JSP apparue a partir de la version 1.1 des 
specifications. 

Exemple d'utilisation d'une balise choose dans une page JSP 

<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 
<html> 

<c:choose> 

<c:when test="${empty sessionScope . cart}"> 

Le panier est vide 
</c :when> 
<c:otherwise> 

Le panier contient des articles 
</c:otherwise> 
</c:choose> 
</html> 



A LIRE JSFet Struts 



JSF 1.2 



CO Bill Dudney, Jonathan Lehr, Bill Willis, 

LeRoy Mattingly, Mastering JavaServer 

Faces, 2004, Wiley 
£0 Jean-Charles Felicite, Developpement 

Java sous Struts, ENI, 2006 
£0 Jean-Charles Felicite, Struts 1.2 : les bases 

pour un developpement Open Source 

Java, ENI, 2006 
IB Vic Cekvenich, Wolfgang Gehner, Struts : 

les bonnes pratiques pour des 

developpements web reussis, Dunod, 

2005 

► http://struts.apache.org/ 



Le chapitre 7 se concentre sur le developpement 
web de I'application YAPS Pet Store. Chaque API y 
est expliquee ainsi que la maniere de les assem- 
bler pour obtenir un site web. 



JavaMail Les protocoles de messagerie 

Le protocole SMTP (Simple Mail Transfer Pro- 
tocol) est le protocole standard de messagerie. Le 
protocole POP [Post Office Protocol) permet 
d'aller recuperer son courrier sur un serveur distant 
et Imap (Internet Message Access Protocol) 
est une alternative a POP offrant plus de possibi- 
lity (comme la gestion d'acces simultanes, de plu- 
sieurs boites aux lettres...). 



A XSD 

XSD, ou XML Schema Description, est un Ian- 
gage de description de format de document XML 
permettant de definir la structure d'un document 
XML. XSD est communement appele grammaire. 



Entre les servlets et les JSP, il manquait un framework pour aiguiller, de 
maniere simple, un evenement utilisateur vers une action serveur. Des 
outils libres comme Struts sont venus aider le developpeur en decorre- 
lant la couche presentation de la couche metier. Mais aucune specifica- 
tion n'existait jusqu'a l'apparition de JSF. Java Server Faces est venu 
combler ce vide en facilitant la conception d'interfaces graphiques web, 
en gerant automatiquement l'etat HTTP ainsi que les evenements entre 
client et serveur. 

JSF etablit une norme dont le role est de fournir aux developpeurs une 
large palette d'outils leur permettant d'implementer des applications 
web en respectant un modele bien precis. 

Le conteneur de servlet 

Le cycle de vie d'une servlet, done d'une JSP, est assure par le moteur de 
servlet (aussi appele conteneur de servlet ou conteneur web). Celui-ci est 
responsable de fournir la requete HTTP a la servlet, de l'executer et de 
renvoyer la reponse. C'est le « moteur » de toute application web simple, 
e'est-a-dire ne mettant pas en jeu d'EJB. 

JavaMail 1.4 

JavaMail est l'API standard de gestion de courriers electroniques de 
Java EE. Elle permet d'envoyer et de recevoir du courrier electronique et 
de manipuler les messages (en-tete, sujet, corps, pieces jointes...). Java- 
Mail n'est pas un serveur de courrier en tant que tel, mais plutot un outil 
pour interagir avec ce type de serveur. II peut etre vu comme un type de 
client de messagerie au meme titre que Outlook, Lotus, Eudora, etc. 
Pour envoyer ou recevoir des messages, JavaMail utilise differents proto- 
coles comme SMTP, Imap ou POP. 

JAXB 2.0 

JAXB est l'acronyme de Java Architecture for XML Binding. Cette API 
permet de generer des classes Java a partir de schemas XML (XSD) et 
inversement. Autrement dit, il permet de convertir les fichiers XSD en 
classes Java. II est ensuite possible de manipuler le document XML au 
travers de ces classes. 

Une fois de plus, les annotations de Java 5 sont venues simplifier l'utili- 
sation de 1API JAXB. En annotant un Pojo (Plain Old Java Object), on 
peut ensuite obtenir ses attributs au format XML. 
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Exemple d'annotations JAXB 



@XmlRootE1 ement 

public class Adresse { 

@Xm1 ID 

private Long identifiant; 
private String rue; 

} 

Grace aux annotations situees dans la classe, JAXB pourra generer auto- 
matiquement la structure XML suivante : 

XML genere par ces annotations 

<adresse> 

<i denti f i ant> </identifiant> 

<rue> </rue> 
</adresse> 

Services web 

Comment faire dialoguer des logiciels ecrits dans des langages de pro- 
grammation differents et fonctionnant sur des systemes d'exploitation 
divers et varies ? La reponse est simple : en utilisant des services web. 
Les services web permettent cette interoperabilite en s'appuyant sur un 
ensemble de protocoles repandus comme HTTP. Cette communication 
est basee sur le principe de demandes et reponses, effectuees via des 
messages XML. 

Les services web sont decrits par des documents WSDL (Web Service 
Description Language), qui precisent les methodes pouvant etre invo- 
quees, leurs signatures et les points d'acces de service (URL, port). Les 
services web sont accessibles via Soap, la requete et les reponses sont des 
messages XML transportes sur HTTP. 

Exemple de service web 
@WebService 

public class MonWebServi ce { 
// Le code metier 
public void maMethode() { 
return ; 

} 

} 



A LIRE Services web 



CQ Annick Fron, Architectures reparties en 
Java : RMI, CORBA, JMS, sockets, SOAP, 
services web, Dunod, 2007 

(2 Hubert Kadima, Valerie Monfort, Les Web 
Services - Techniques, demarches et 
outils, Dunod, 2003 

Q Libera Maesano, Christian Bernard, Xavier 
Le Galles, Services Web avec J2EE et .NET, 
Eyrolles, 2003 

CQ Steve Graham, Doug Davis, Simeon 
Simeonov, Glen Daniels, Building Web 
Services with Java: Making Sense of 
XML, Soap, WSDL, and UDDI, Sams, 2004 



Le chapitre 9 presente les services web ainsi que 
les technologies qui y sont rattachees. Les services 
web sont utilises par I'application YAPS Pet Store 
pour communiquer avec les partenaires externes. 



//, Soap 



Simple Object Access Protocol est un proto- 
col standard destine aux services web. Lance par 
IBM et Microsoft, il permet d'utiliser des applica- 
tions invoquees a distance par Internet. 



Blueprints 

Parallelement a la plate-forme Java EE, Sun propose gratuitement des 
documents pour faciliter les developpements Java : les Blueprints. Ces 



39 



derniers contiennent des tutoriaux, des design patterns, des exemples de 
code, des conseils et des FAQs. 

II existe plusieurs types de Blueprints. Sous le succes des services web, 
Sun a developpe en 2004 un Blueprint baptise Adventure Builder. Cette 
application vous permet de personnaliser un sejour pour vos vacances, en 
utilisant principalement des services web. 

Concernant Java EE (ou J2EE a l'epoque), Sun crea le Java Pet Store. 



Architecture Pet Store 



Les Blueprints de Sun se trouvent a I'adresse 
suivante : 

► http://java.sun.com/reference/blueprints/ 
En ce qui concerne le Pet Store, vous pouvez con- 
suiter les adresses suivantes : 

► http://blueprints.dev.java.net/petstore/ 

► http://java.sun.com/developer/releases/ 
petstore/ 



Remarque Les autres Pet Store 

Le Pet Store de Sun a ete source d'inspiration pour 
d'autres technologies ou frameworks. Ci-dessous 
une liste non exhaustive de ces Pet Store : 

• PetShop : utilisation du framework .NET de 
Microsoft ; 

• xPetStore : utilisation des tags xDoclet ; 

• Flash PetStore : version de Macromedia utili- 
sant la technologie Flash ; 

• Spring PetStore : utilisation du framework 
Spring ; 

• openMDX PetStore : plate-forme Open Source 
MDA. 



Figure 2-4 

Page d'accueil du Java Pet Store de Sun 



Java Pet Store 

Java Pet Store est une application Java EE que Sun a cree pour son pro- 
gramme de Blueprints. C'est un site web marchand ou Ton peut choisir des 
animaux domestiques, les ajouter dans un panier, puis payer electronique- 
ment. Ce Blueprint a permis de documenter les meilleures pratiques (code 
Java, design pattern, architecture) pour developper une application Java EE. 
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Java™ Pet Store 

J2EE™ Blueprints Sample Application 
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The Java Pal Store Demo is a fictional sample application from the Java DluePnnts for ihe enterprise Toi n 
the Java OluePnnls tot the Cntetpnse Web sfte at tm ™ .w.t..... .*—/..»■.... 



Java BiuePnnti for (he EMerpnse 1 Jm Software I 
O 2001 Gun Microsystems Inc. ^Jl nghis reserved Use is subject to 




Le Java Pet Store est aussitot devenu un standard de facto, puisque les 
constructeurs de serveur d'applications l'ont utilise pour demontrer la 
compatibilite de leur produit avec les specifications Java EE. En effet, 
Oracle fut le premier a l'utiliser pour ses tests de montee en charge. Bien 
que Java Pet Store ait ete developpe a des fins educatives, Oracle declara 
que cette application fonctionnait deux fois plus rapidement sur son ser- 
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veur d'applications que sur ceux de BEA ou IBM. La communaute 
s'enflamma et tous les vendeurs commencerent a utiliser le Java 
Pet Store pour demontrer leurs meilleures performances. 

Cette anecdote contribua a augmenter la popularite de ce Blueprint, qui 
rentra tres vite dans le langage commun. Tout le monde commenca a l'utiliser 
pour illustrer une nouvelle technologie, une nouvelle idee ou implementation. 

L'etude de cas de cet ouvrage s'inspire de ce site de commerce electronique. 

Les design patterns 

Dans son livre A Pattern Language edite en 1977, l'architecte en batiment 
Christopher Alexander introduit le terme de pattern (patron) : « chaque 
patron decrit un probleme qui se produit de maniere recurrente dans notre 
environnement ». Si ce livre est dedie a une autre profession que celle de 
l'architecture informatique, il faudra attendre le livre du Gang of Four 
(GoF) en 1994 pour adapter ces idees au monde de l'oriente objet. 

II ne faut pas confondre ces patrons avec des briques logicielles (un pattern 
depend de son environnement), des regies (un pattern ne s'applique pas 
mecaniquement) ou des methodes (ne guide pas la prise de decision). Mais 
plutot les voir comme une solution de conception a un probleme recurrent. 

Viendront alors, bien plus tard, deux livres s'inspirant du GoF mais 
dedie a la plate-forme J2EE : EJB Design Pattern et Core J2EE Patterns. 
Ces trois ouvrages ont cree un vocabulaire commun entre les deve- 
loppeurs, concepteurs et architectes. 

Ce livre utilisera plusieurs design patterns pour concevoir l'application 
YAPS Pet Store. 

UML2 

UML {Unified Modeling Language ou langage de modelisation unifie), 
est ne de la fusion des trois methodes qui ont le plus influence la modeli- 
sation objet au milieu des annees 1990 : OMT, Booch et OOSE. Issu 
d'un travail d'experts reconnus (James Rumbaugh, Grady Booch et Ivar 
Jacobson), UML est le resultat d'un large consensus qui est vite devenu 
un standard incontournable. Fin 1997, ce langage est devenu une norme 
OMG {Object Management Group). 

UML est un langage de modelisation objet et non une demarche d'analyse. II 
represente des concepts abstraits de maniere graphique. UML est done un 
langage universel et visuel qui permet d'exprimer et d'elaborer des modeles 



A GoF 

Le Gang of Four designe les quatre auteurs du 
livre Design Pattern, e'est-a-dire Erich Gamma, 
Richard Helm, Ralph Johnson et John Vlissides 



//. Les anti-patterns 

Les anti-patterns sont des erreurs courantes de 
conception de logiciels. Leur nom vient du fait que 
ces erreurs sont apparues des les phases de con- 
ception du logiciel, notamment par I'absence ou la 
mauvaise utilisation de design pattern. 



A LIRE Design pattern 

HI Erich Gamma, Richard Helm, Ralph 

Johnson, John Vlissides, Design Pattern, 

Addison-Wesley, 1995 
ffl Floyd Marinescu, EJB Design Patterns, 

Wiley, 2002 
Q Deepak Alur, Dan Malks, John Crupi, Core 

J2EE Patterns, Prentice Hall, 2003 
III Laurent Debrauwer, Design Patterns - 

Les 23 modeles de conception : 

descriptions et solutions illustrees en 

UML 2 etJava, ENI, 2007 
III Steven-John Metsker, William C. Wake, 

Les Design Patterns en Java, Campus 

Press, 2006 



A OMG 

L'objectif de VObject Management Group est 
de standardiser et de promouvoir le modele objet 
sous toutes ses formes. L'OMG est notamment a la 
base des specifications UML, MOF, CORBA, IDL et 
MDA. 
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Approfondir uml 



tfl Pascal Roques, UML 2 - Modeliser une 
application web, Eyrolles, 2007 

CO Pascal Roques, Franck Vallee, UML 2 en 
action : de /'analyse des besoins a la 
conception, Eyrolles, 2007 

CO Xavier Blanc, Isabelle Mounier, UML 2 
pour les developpeurs - Cours avec 
exercices corriges, Eyrolles, 2006 

CO Jim Arlow, Ha Neustadt, UML2 and the 
Unified Process, Addison-Wesley, 2005 

► http://www.uml.org/ 



A Architecture 



[.'architecture specifie la structure d'un systeme. 
On parle d'architecture fonctionnelle pour definir 
les services du systeme, d'architecture technique 
pour les composants techniques utilises et d'archi- 
tecture applicative pour decrire le decoupage en 
sous-systemes. 



Architecture Couches ou tiers 

Lorsqu'on parle d'architecture en couches, on utilise 
souvent le terme anglais tiers. Ce terme signifie 
couche et non le tiers mathematique (1/3). On 
entend par consequent les architectes parler d'archi- 
tecture quatre tiers ou cinq tiers. II ne faut pas com- 
prendre par la que I'architecture est en 4/3 ou 5/3 
mais bien qu'elle est decoupee en 4 ou 5 couches. 



UML Paquetages et sous-systemes 

Un paquetage {package en anglais) est un meca- 
nisme destine a regrouper des elements comme 
des classes, des cas d'utilisation, voire d'autres 
paquetages. Le terme sous-systeme (subsystem) 
indique que le paquetage represente une partie 
independante du systeme. Ci-apres la representa- 
tion graphique UML d'un paquetage et d'un sous- 
systeme. 




Subsystem 



objet, independamment de tout langage de programmation. Comme UML 
n'impose pas de methodes de travail particulieres, il peut etre integre a 
n'importe quel processus de developpement logiciel de maniere transparente. 

UML 2 introduit quatre nouveaux diagrammes (paquetages, structures 
composites, global d'interaction et de temps) qui viennent enrichir les 
neufs initiaux (classes, objets, composants, deploiement, cas d'utilisa- 
tion, etats-transitions, activites, sequence et communication). La plupart 
de ces diagrammes seront utilises tout au long des chapitres. 



Architecture de Implication 

Lapplication YAPS Pet Store va done utiliser toutes les technologies 
enoncees ci-dessus. Comme nous l'avons vu au chapitre precedent, Pre- 
sentation de Tetude de cas, on accede a l'application par des navigateurs 
(client leger utilise par les internautes) et par les clients riches (deve- 
loppes en Swing) deployes sur les postes des employes. Ces interfaces 
graphiques accedent elles-memes a un serveur qui va effectuer les traite- 
ments metier puis stocker les donnees dans une base. 

Pour ce faire, l'application YAPS Pet Store est decoupee en plusieurs 
couches. 



[.'architecture en trois couches 

On peut done dire que I'architecture logique de l'application YAPS 
Pet Store est decoupee en trois couches (ou trois niveaux). Larchitecture 
en trois couches est le modele le plus general des architectures multicou- 
ches. Ces couches sont : 

• presentation des donnees : affichage sur le poste de travail des don- 
nees du systeme et interaction avec l'utilisateur ; 

• traitements metier : ensemble des regies metiers de l'application ; 

• acces aux donnees : manipulation et conservation des donnees. 

Ci-apres un diagramme de paquetages UML representant ces trois cou- 
ches. Chaque sous-systeme contient les technologies Java EE 5 utilisees 
dans l'application. 



Figure 2-5 Paquetage et sous-systeme 



Figure 2-6 

Architecture Java EE 
en trois couches 
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Architecture applicative 



Le precedent modele en trois couches peut etre affine pour etre plus 
fidele a 1' architecture finale de 1' application YAPS Pet Store. Ci-apres un 
diagramme de paquetage decrivant les couches de 1' application : 



Presentation 




Interoperabilite 


HTML 
JSP 

JSTL 
JSF 
UEL 

Svyng 
RMI 




XML 
WebService 
SOAP 
JAXB 




A 






Traitement metier 

Stateless Bean 
Entity Bean 
Statelul Bean 
MDB 
JNDI 
JavaMail 
JMS 


i 
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Navigation 
JSF 


--> 



Base de donnees 
relationnelle 




Figure 2-7 

Couches de I'application YAPS Pet Store 



Couche de presentation 

La couche de presentation est la partie visible de I'application qui permet 
a un utilisateur d'interagir avec le systeme. Elle relaie les requetes de 
l'utilisateur a destination de la couche metier, et en retour lui presente les 
resultats renvoyes par les traitements. On parle alors d'interface homme- 
machine (IHM) et aucun traitement n'est implemente dans cette 
couche. L'application YAPS Pet Store possede deux types d'interfaces 
homme-machine : un client leger et un client riche. 

Le client leger, utilise par l'internaute, est decrit en langage HTML puis 
interprete par le navigateur. Dans le cas du YAPS Pet Store, nous ne 
developperons pas directement l'interface en HTML, mais plutot a 
l'aide de JSP et de tags JSF et JSTL ainsi que du langage d'expression. 
Les appels a la couche metier sont delegues a la couche navigation. 

Le client riche, lui, est developpe en Swing et utilise le protocole RMI 
(Remote Method Invocation) pour communiquer avec la couche metier. 
Pour afficher les evenements asynchrones recus de I'application, cette 
couche utilise egalement JMS. 



JMS L'application Swing 



L'expression des besoins nous signale que les 
employes veulent etre avertis lorsqu'un bon de 
commande contient des reptiles. Pour ce faire, 
l'application ecoutera sur une file d'attente JMS et 
sera alertee a chaque fois qu'un reptile est vendu. 



Couche de navigation 

Cette couche, uniquement utilisee par le client leger, prend en charge la 
logique de navigation. De ce fait, elle gere l'enchainement des JSP ainsi 
que les appels aux traitements metier. Cette couche est mise en ceuvre 
par la technologie JSF. 
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Couche de traitement metier 



A CRUD 

CRUD est un terme communement utilise pour 
I'acces aux bases de donnees. II signifie en anglais 
Create, Retrieve, Update and Delete, c'est-a- 
dire creation, lecture, mise a jour et suppression de 
donnees. 



//. Les bases de donnees objets 

Les bases de donnees objets, comme leur nom 
I'indique, organisent les donnees sous forme 
d'objets et non sous forme de tables (lignes et 
colonnes). Bien que certains grands acteurs du 
monde relationnel aient des implementations 
objets, les bases objets n'ont jamais vraiment 
perce sur le marche. 



A JAX-WS 

JAX-WS est la nouvelle appellation de JAX-RPC 
(Java API for XML Based RPC) qui permet de 
developper tres simplement des services web. 



La couche de traitement metier correspond a la partie fonctionnelle ou 
metier de 1' application. Elle implemente la logique et les regies de ges- 
tion permettant de repondre aux requetes de la couche presentation. 

Pour fournir ces services, elle s'appuie, le cas echeant, sur les donnees du 
systeme, accessibles au travers des services de la couche inferieure, c'est- 
a-dire la couche de donnees. En retour, elle renvoie a la couche presenta- 
tion les resultats quelle a calcules. 

En pratique, on trouve au niveau de la couche metier : 

• des entities dont la persistance est assuree par la couche de mapping ; 

• des stateless beans qui proposent des methodes pour manipuler les 
entities (CRUD) ; 

• des message-driven beans qui assurent les traitements asynchrones ; 

• les API JNDI, pour acceder au service de nommage, et JavaMail, 
pour envoyer des e-mails aux clients. 

Les appels vers les systemes externes (BarkBank et PetEx) sont orches- 
tras par la couche metier mais delegues a la couche d'interoperabilite. 

Couche de mapping objet/relationnel 

La couche de mapping objet/relationnel transforme la representation 
physique des donnees en une representation objet et inversement. Ce 
mecanisme est assure par JPA qui utilise le protocole JDBC pour exe- 
cuter les appels SQL. Cette couche n'est utilisee que parce que notre 
base de donnees est relationnelle. En effet, si la persistance etait faite de 
maniere native en objet, ce mapping n'aurait pas lieu d'etre. 

Couche de persistance 

Cette couche contient les donnees sauvegardees physiquement sur 
disque, c'est-a-dire la base de donnees. En Java, le protocole d'acces aux 
donnees est JDBC. 

Couche d'interoperabilite 

Pour dialoguer avec ses partenaires BarkBank et PetEx, 1' application uti- 
lise une couche d'interoperabilite. Basee sur les technologies JAX-WS, 
elle accede a des services web distants via le protocole HTTP. 

Architecture technique 

Les couches que nous venons de decrire sont avant tout logiques et ser- 
vent a decrire la conception de 1' application. Nous allons maintenant 
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projeter cette architecture sur un ou plusieurs emplacements physiques. 
Le diagramme de deploiement ci-apres nous montre les machines physi- 
ques utilisees. Pour l'application a proprement parler, il n'y a dans notre 
cas qu'un seul serveur physique. Mais nous aurions pu subdiviser. Les 
autres machines correspondent aux postes des internautes, des employes 
et des partenaires externes. 



«d»vie*» 
Serveur prvacue de Y aps 



JNDI 
JavaMail 

JAXH 



:<eieajtiontnvironment» 
Setveui dappiitaUun 



««xeaitionEnwonment>» 
Coiteneur de Serwlets 



■ : <com Danent> 
Corlroleur JSP ' 



ipomrkV* £] 

Page JSP < Tags JSF 



Postc dc I'l tOTMUlc 



< exe cut) onE rtvronme rn» 
CorteneurdXJOs 




v^eneaitionCnvironmentvi 
B jee de domeee 



mponent» £1 
WebService 



UML Le diagramme de deploiement 

Le diagramme de deploiement montre la disposi- 
tion physique des materiels qui composent le sys- 
teme et la repartition des composants sur ces 
materiels. Les ressources materielles sont repre- 
sentees sous forme de noeuds (les cubes) qui peu- 
vent etre lies entre eux a I'aide d'un support de 
communication. Le stereotype «devi ce» ren- 
force le fait que le noeud est un serveur physique, 
alors que «executf onEnvi ronment» est 
utilise pour les logiciels tels qu'un serveur dupli- 
cations ou de base de donnees. 



Figure 2-8 

Diagramme de deploiement de l'application 



Le serveur physique comporte une base de donnees et un serveur 
d'applications. Ce dernier est compose d'un conteneur de servlets et 
d'un conteneur d'EJB. A l'interieur de chaque nceud (represente sous 
forme de cube), on peut voir les composants qui sont deployes. Pour la 
partie web, on retrouve les JSP, JSF et JSTL, alors que le conteneur 
d'EJB heberge les stateless, stateful, MDB et entities. Les services web 
sont deployes sur les serveurs des partenaires. 



En resume 

Ce chapitre nous a presente les differents langages ainsi que la plate- 
forme Java EE 5 avec lesquels sera developpee l'application YAPS 
Pet Store. Larchitecture en couches a ete detaillee a I'aide de dia- 
grammes de paquetages et de deploiement. Nous avons desormais defini 
et recense les technologies et specifications qui seront utilisees dans les 
differentes couches applicatives. 



Precision Machine physique 



La repartition des composants sur differentes 
machines est une vision ideale de I'architecture. 
Pour simplifier le deploiement de la totalite de 
l'application, nous n'utiliserons qu'une seule 
machine qui hebergera le serveur d'applications, 
les services web ainsi que les interfaces homme- 
machine. 
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Outils et installation 



Les chapitres precedents ont permis de presenter 

les fonctionnalites, le contenu de l'application YAPS 

Pet Store ainsi que son architecture et les technologies 

utilisees. Avant de commencer les developpements, 

ce chapitre nous presente les outils que nous allons utiliser, 

leur installation et leur configuration. 



SOMMAIRE 

► Outils utilises pour 
le developpement 

► Installation de Ant et du JDK 

► Installation et configuration 
du serveur GlassFish 

► Administration de GlassFish 

► Installation de Derby 

► Creation de la base de donnees 
Derby 

MOTS-CLES 

► JDK 

► Ant 

► GlassFish 

► Derby 

► DataSource 

► Pool de connexions 

► JMS 



Logiciel libre 



Ce qui caracterise les logiciels libres (Open 
Source), c'est leur code source. En effet, celui-ci est 
visible, modifiable et librement redistribuable sous 
certaines conditions (licence). 



Plusieurs outils seront utilises pour developper notre etude de cas. lis ont 
tous la particularite d'etre gratuits et parfois meme Open Source (logiciels 
libres). II ne vous en coutera done rien de les installer et de les utiliser. 



Outils utilises pour le developpement de 
I'application 



TELECHARGER JDK 1.5 



► http://java.sun.com/javase/ 



JDK 

Indispensable pour le developpement et 1' execution de notre application, 
le Java Development Kit, communement appele JDK, est le kit de deve- 
loppement propose gratuitement par Sun. II comprend plusieurs outils, 
parmi lesquels : 

• javac : le compilateur Java ; 

• j ava : un interpreteur d'applications (machine virtuelle) ; 

• javadoc : un generateur de documentation ; 

• jar : un outil de compression de classes Java. 

Le JDK nous permettra de compiler et d'executer I'application, de meme 
que d'autres outils tels que Ant. 



TELECHARGER Ant 1.7 



► http://ant.apache.org/ 



Ant 

Ant est au monde Java ce que Make est au monde du langage C : un 
outil incontournable pour automatiser des traitements repetitifs en mode 
batch (suppression de fichiers, compilation, compression de fichiers, 
etc.). II est simple d'utilisation, bati sur des technologies ouvertes (Java 
et XML), extensible et supporte par de nombreux logiciels. Cet outil est 
aujourd'hui plebiscite par l'ensemble des acteurs majeurs de la commu- 
naute Java et communement employe dans la majorite des realisations 
d'entreprise 

Ant sera utilise pour automatiser la compilation, le packaging et le 
deploiement de I'application. II nous permettra aussi d'inserer physique- 
ment des donnees en base et d'administrer le serveur d'applications. 



GlassFish 

GlassFish est un serveur d'applications certifie Java EE 5. Son develop- 
pement a ete initie lorsque Sun a ouvert le code de son serveur d'applica- 
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tions pour le licencier en Open Source. II utilise le moteur de persistance 
d'Oracle, TopLink Essentials. 

GlassFish est constitue de : 

• un serveur web dedie au service de fichiers, c'est-a-dire a des pages 
HTML statiques, images, videos, etc. ; 

• un conteneur de servlets, hebergeant des applications composees de 
servlets et/ou JSP ; 

• un conteneur d'EJB, pour la gestion des composants stateless, sta- 
teful, MDB et entities ; 

• l'lmplementation de l'API de persistance JPA d'Oracle (TopLink 
Essentials). 

Comme nous le verrons, 1'administration du serveur GlassFish se fait 
soit par interface web, soit par ligne de commande. 

GlassFish hebergera l'application YAPS Pet Store ainsi que les services 
web des partenaires BarkBank et PetEx. 



Serveur d' applications Compatibility Java EE 5 

GlassFish n'est pas le seul serveur d'applications 
Open Source a supporter la totalite des specifica- 
tions Java EE 5 . Le code que nous allons deve- 
lopper est portable a 99 % sur tout serveur 
d'applications. Retrouvez toutes les informations 
necessaires pour migrer vers tel ou tel autre ser- 
veur d'applications a I'URL suivante : 
► http://www.antoniogoncalves.org 



Telecharger GlassFish 
► https://glassfish.dev.java.net/ 



Derby 

Anciennement appelee Cloudscape, cette base de donnees developpee en 
Java a ete donnee a la fondation Apache par IBM. De petite taille 
(2 Mo), cette base de donnees relationnelle est integree au serveur Glass- 
Fish. Nous utiliserons Derby pour stacker les donnees de l'application. 



Telecharger Derby 



► http://db.apache.org/derby/ 



Environnement de developpement 

Lenvironnement minimal pour developper l'application se compose 
d'un JDK, de Ant et d'un simple editeur de texte. Cependant, il est 
important d'avoir un outil integre pour vous permettre d'accelerer vos 
developpements (IDE ou Integrated Development Environment). Vous 
pouvez ainsi utiliser Eclipse, ou NetBeans, en ce qui concerne les outils 
Open Source, ou tout autre IDE de votre choix si vous en possedez la 
licence. 

Pour ma part, j'utilise depuis longtemps IntelliJ IDEA de JetBrains (voir 
annexe E). A ce sujet, je remercie la societe JetBrains de m'avoir offert 
une licence pour la version 7 de leur excellent produit. 



Outils Eclipse, NetBeans, IntelliJ IDEA 

Initialement lance par IBM, Eclipse est un IDE 
Open Source extensible et polyvalent. Utilise par 
beaucoup de developpeurs Java, vous pourrez le 
telecharger a I'adresse suivante : 

► http://www.eclipse.org/ 
NetBeans est le pendant chez Sun : 

► http://www.netbeans.org/ 

IntelliJ IDEA est payant, mais vous pouvez utiliser 
une licence devaluation pour essayer le produit : 

► http://www.jetbrains.com/idea/ 



Outil de modelisation UML 

Si vous voulez dessiner des diagrammes UML, il existe plusieurs outils 
disponibles en Open Source (ArgoUML, StarUML, etc.) ou sous forme 
de plug-in pour Eclipse, NetBeans ou Idea. 
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UML Outils de modelisation 

ArgoUML, StarUML et Poseidon sont des outils 
Open Source que vous pourrez retrouver respecti- 
vement aux adresses suivantes : 

► http://argouml.tigris.org/ 

► http://staruml.sourceforge.net 

► http://www.gentleware.com 

Visual Paradigm possede une large panoplie 
d'outils de modelisation dont la Community Edi- 
tion qui est gratuite : 

► http://www.visual-paradigm.com/ 



Les diagrammes que vous verrez dans ce livre ont ete dessines avec l'outil 
Visual Paradigm. Cet outil s'integre aussi sous forme de plug-in dans 
IntelliJ IDEA, Eclipse, NetBeans et bien d'autres IDE. Je remercie la 
societe Visual Paradigm de m'avoir offert une licence pour leur edition 
Smart Development Environment. 



Installation des outils 

Dans cette section, nous allons installer les trois principaux outils utilises 
tout au long de l'ouvrage. 



JDK 1.5 



TELECHARGER JDK 1.5 



► http://java.sun.com/javase/downloads/ 
indexjdk5.jsp 



Telechargez l'executable d'installation sur le site officiel de Sun. Le nom 
de cet executable differe selon la plate-forme sur laquelle vous souhaitez 
l'installer. Par exemple : 

• Windows : jdk-l_5_0_15-windows-i586-p.exe ; 

• Linux : jdk-l_5_0_15-linux-i586-rpm.bin ; 

• Solaris Sparc : jdk-l_5_0_15-solaris-sparc.sh. 

L'installation se fait alors sans difficultes particulieres. Un premier ecran 
vous invite a accepter la licence du logiciel, puis le second les modules du 
JDK que vous souhaitez installer (figures 3-1 et 3-2). L'installation 
s'acheve avec un ecran vous informant de son bon deroulement. 



Figure 3-1 

Acceptez la licence et cliquez sur Next. 



J2SE Development Kit 5.0 Update 15 License 




|Sun Microsystems, Inc. Binary Code License Agreement 
for the JAVA 2 PLATFORM STANDARD EDITION DEVELOPMENT KIT 5.0 



KOSYSTEMS, INC. ("SUN") is willing to license the software identified 

BELOW TO YOU ONLY UPON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS 

NTAINED IN THIS BINARY CODE LICENSE AGREEMENT AND SUPPLEMENTAL LICENSE 
jTERMS (COLLECTIVELY "AGREEMENT"). PLEASE READ THE AGREEMENT CAREFULLY. BY 
[DOWNLOADING OR INSTALLING THIS SOFTWARE, YOU ACCEPT THE TERMS OF THE 
AGREEMENT INDICATE ACCEPTANCE BY SELECTING THE "ACCEPT" BUTTON AT THE 
BOTTOM OF THE AGREEMENT. IF YOU ARE NOT WILLING TO BE BOUND BY ALL THE TERMS, 
[SELECT THE "DECLINE" BUTTON AT THE BOTTOM OF THE AGREEMENT AND THE 



0 1 act e p t the t e r rn 5 in the 1 1 c ens e ■■ \\ • r-ment 

O I do not accept the terms in the license agreement 



IShield 
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1 J2SE Development Kit 5.0 Update 1 5 - Custom Setup 



Custom Setup 

Select the program features you want installed. 



Select optional features to install from the list below. You can change your choice of features after 
installation by using the Add/Remove Programs utility in the Control Panel 

Feature Description 
J25E Development Kit 5.0, 
n including private 3RE 5.0. This 

will require 264 MB on your hard 
Source Code drive 

Public JRE 



Install to 

F:\ToolsyDK\jdkl. 5.0_15\ 



Change.. 



Figure 3-2 

Selectionnez les modules a installer 
et cliquez sur Next. 



L'installation terminee, il faut positionner la variable JAVAJOME (par 
exemple, set jAVA_HOME=F:\Tools\JDK\jdkl.5.0_15) et raj outer le repertoire 
bin dans la variable systeme PATH (pour notre exemple 
PATH=%J AVA_HOME%\bi n ; %PATH%) a partir d'une fenetre de commande. Verifiez 
que l'interpreteur j ava est reconnu en tant que commande interne en tapant 
la commande java -version dans votre fenetre de commande (figure 3-3). 



] 



A Les variables d'environnement 

Les variables d'environnement sont des variables 
utilisees par le systeme pour partager des informa- 
tions de configuration entre differents pro- 
grammes. Une variable d'environnement tres 
utilisee sous Windows est la variable path. Elle 
contient la liste des dossiers dans lesquels Win- 
dows ira chercher les commandes par defaut. 



Figure 3-3 

Affichage de la version du JDK 
dans une fenetre de commande 





B-|g|x 


F:\>echo V. JflUflJOME/! 

F : SIoo IsSJDKS jdkl .5.05 


E 


F:\>jawa -version 
java version "1.5.0J.5" 
Java<TM> 2 Runtime Environr 
Java HotSpot<TM> Client UM 


lent. Standard Edition <build 1 .5 .0_15-b04> 1 
(build 1 .5 .0_15-b04, nixed node, sharing) 1 


F:\> 





Retour "'experience Des espaces dans les chemins 

Java n'apprecie guere que vous installiez des outils ou des librairies dans 
des repertoires contenant des espaces (par exemple, c:\Program Files 
ou d:\Mes Outils). II faut alors rajouter des guillemets sur les chemins 
d'acces (par exemple, "c:\Program Fi 1 es" ou "d : \Mes Outils"). Les 
applications Java ont frequemment besoin de librairies externes qui doi- 
vent etre rajoutees dans la variable Classpath. On se retrouve alors 
avec des erreurs de type ClassNotFoundException car les chemins 
d'acces aux librairies contiennent des espaces et que l'interpreteur Java 
n'arrive pas a retrouver les classes necessaires. Pour eviter ce genre de 
problemes et devoir rajouter des guillemets un peu partout, vous 
pouvez installer vos outils et librairies dans des repertoires ne contenant 
pas d'espace (par exemple, c : \Tool s ou d : \Mes0uti 1 s). 
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Ant 1.7 



Telecharger Ant 1.7 



► http://ant.apache.org/bindownload.cgi 



Remarque Ant 1.6.5 



Les scripts ont ete testes et fonctionnent correcte- 
ment pour les versions 1 .7 et 1 .6.5 de Ant. 



^installation de Ant se limite a decompresser un fichier. Selon la plate- 
forme et le mode de compression utilises, vous telechargerez le fichier 
suivant : 

• apache-ant-1.7.0-bin.tar.bz2 ; 

• apache-ant-1.7.0-bin.tar.gz ; 

• apache-ant-L7.0-bin.zip. 

Decompressez le fichier telecharge dans un repertoire et positionnez la 
variable ANT_HOME (par exemple, set ANT_HOME=F:\Tools\Ant\apache- 
ant-1.7.0). Rajoutez le repertoire %ANT_HOME%\bi n dans la variable sys- 
teme PATH. Verifiez que l'interpreteur ant est reconnu en tant que com- 
mande interne en tapant la commande ant -version dans une fenetre de 
commande (figure 3-4). 



Figure 3-4 

Affichage de la version de Ant 
dans une fenetre de commande 



F:\>echo zflNIJOMEz 

F : SIoo IsSAnt \apaclie-ant-l .7.0 

F:\>ant -version 

Apache Ant version 1.7.0 compiled on December 13 2006 
F:\> 



]d|x] 



Telecharger Les f ichiers 
admin.xml et build. xml 



Telechargez le code source de I'application YAPS 
Pet Store. A la racine de I'archive, vous trouverez 
les deux fichiers admi n . xml et bin 1 d . xml . 
► http://www.antoniogoncalves.org 



Telecharger GlassFish Ml 

► https://glassfish.dev.java.net/public/ 
downloadsindex.html 



Une fois Ant installe, nous pourrons l'utiliser pour administrer et deve- 
lopper I'application YAPS Pet Store. Les differentes taches Ant sont 
regroupees dans deux fichiers distincts : 

• admi n . xml : contient les taches d'administration ; 

• build. xml : les taches pour le developpement de I'application. 

GlassFish V2 

L'installation du serveur GlassFish necessite plus d'operations que les ins- 
tallations precedentes, mais reste tout de meme tees simple. Tout d'abord, 
telechargez le fichier compresse correspondant a votre plate-forme : 

• Windows : gl assfi sh-i nstal 1 er-v2ur2-b04-wi ndows .jar ; 

• Linux : glassfish-installer-v2ur2-b04-linux. jar ; 

• Solaris Sparc : gl assfi sh-i nstal 1 er-v2ur2-b04-sunos . jar. 

Decompressez le fichier en tapant la commande suivante (pour 
Windows) : 

| java -Xmx256m -jar gl assfi sh-i nstal 1 er-v2ur2-b04-wi ndows . jar 
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Une fenetre s'affiche contenant la licence d'utilisation du produit. Vous 
devez faire defiler l'ecran et cliquer sur Accept (figure 3-5). 



License Agreement 



COMMON DEVELOPMENT AND DISTRIBUTION LICENSE (CDDL) Version 1.0 I 
1 . Definitions . 

1.1. Contributor, means each individual or entity that creates 
or contributes to the creation of Modifications. 

1.2. Contributor Version, means the combination of the Origina 
1 Software, prior Modifications used by a Contributor (if any), a 
nd the Modifications made by that particular Contributor. 

1.3. Covered Software, means (a) the Original Software, or (b) 
Modifications, or (cj the combination of files containing Origin 

al Software with files containing Modifications, in each case inc 
luding portions thereof. 



Product contains autoupdate feature which also collects some system 

data. For more information on data collection see: 
http ://wiki.glassfish. java. net/gfwiki/Uiki. jsp?page=UsageMe tries 

pi Enable autoupdate 



Accept 



Decline 



Figure 3-5 

Affichage de la licence GlassFish 



c\ Open JEE5 




X 


glassf is}i\updatecentei*\lib\jdic\COPVING 




3 


glassf ish\updatecenterxlibxjdic\def nailer .pro pert ies 




glassf ish\updatecenter\libxjdic\jdic .jar 






glassf ish\updatecenter\libsjdicSlinux\jdic_stub. jar 






glassf ish\updatecenter\lib\jdic\linux\x86slibjdic .so 






glassf ishXupdatecenter\lib\jdic\linux\x86\libmozembed-linux-gtkl .2 .so 






glassf ish\updatecenter\libSjdic\linux\x86\libnozenbed-linux-gtk2 .so 






glassf is}i\updatecentei*\lib\jdic\linux\x86\libtray .so 






glassf ish\updatecenter\libSjdic\linux\x86\mozembed-linux-gtkl .2 






glassf ish\updatecenterSlib\jdic\linuxSx86\mozenbed-linux-gtk2 






glassf ish\updatecenter\libSjdicSmac\jdic__stub. jar 






glassf is}i\updatecenter\lib\jdic\nacSppc\libjdic . jnilib 






glassf ish\updatecenter\lib\jdic\nacSppcSlibtray. jnilib 






glassf ish\updatecenterMib\jdic\README.html 






glassf ish\updatecenter\lib\jdic\sunosSjdic_stub. jar 






glassf ish\updatecenterSlibSjdicSsunosSsparcSlibjdic .so 






glassf ish\updatecenter\libSjdicSsunosSsparcSlibnozenbed-solaris-gtkl .2 .so 






glassf ish\updatecenter\lib\jdicSsunosSsparcSlibnozenbed-solaris-gtk2 .so 






glassf ish\updatecenter\lib\jdic\sunosSsparcMibtray .so 






glassf ish\»pdatecenter\lib\jdic\sunos\sparcSnozenbed-solaris-gtkl .2 






glassf isli\iipdatecenter\lib\jdic\sunosSsparcSnozeribed-solaris-gtk2 






glassf ish\updatecenter\lib\jdic\sunos\x86Mibjdic .so 






glassf is}i\updatecenter\lib\jdic\sunos\x86\libmozeribed-solaris-gtk2 .so 






glassf is}i\updatecenter\lib\jdic\sunos\x86\libtray.so 






glassf is}i\updatecenter\lib\jdic\sunos\x86Snozembed-solaris-gtk2 






glassf ish\updatecenter\lib\jdic\windowsSjdic_stub. jar 






glassf isli\updatecenter\lib\jdic\windows\x86\IeEmbed.exe 




i 


glassf ish\updatecenter\lib\jdic\windows\x86Sjdic .dll 






glassf ish\updatecenter\lib\jdic\windows\x86\MozEnbed.exe 






glassf ish\updatecenter\lib\jdic\windows\x86\tray.dll 






glassf ish\updatecenter\lib\jhall. jar 






glassf ish\updatecenter\lib\schema2beans -jar 






glassf ish\updatecenter\lib\schema2beansdeu .jar 






glassf ish\updatecenter\lib\swing-layout-l .0.1 -jar 






glassf ish\updatecenter\lib\updatecenter-gui. jar 






glassf ish\updatecenter\lib\updatecenter- ins taller . jar 






glassf isb\updatecenter\lib\updatecenter-jauahe lp. jar 






glassf ish\updatecenter\lib\updatecenter . jar 






g las s f is hNupdat e c e n t e r \L I CENS E . t x t 






g las s f is hNupdat e c e n t e r \RE A DUE 






glassf ish\updatecenter\registry\SVSTEMslocal.xFil 






installation complete 






F:\Tools\GlassFish> 







Figure 3-6 La decompression du fichier se fait avec succes. 
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La decompression s'effectue automatiquement dans le repertoire courant, 
jusqu'a l'apparition du message : Installation complete (figure 3-6). 

II faut maintenant configurer GlassFish (assurez-vous d'avoir correcte- 
ment positionne les variables JAVA_HOME et ANT_H0ME). Pour ce faire, on 
utilise le fichier Ant setup . xml livre avec GlassFish. Tapez la commande 
suivante : 



ant -f setup. xml 



Open JCC5 



etup.reg: 

[ cl )iu 1 CrtdL iny the scrvitc t'tyisii-y f ile . . 
[jaual Fron Local service registry 



et . jaua . home : 



put .nrni . nni v : 

et .env : 

create .domain : 

[exec] Using port 4848 for fldnin. 

[exec] Using port 8880 for HTTP Instance. 

[exec] Using port 7676 for JMS . 

[exec] Using port 3700 for HOP. 

[exec] Using port 8181 for HTTP_SSL. 

[exec] Using default port 3820 for IIOP_SSL. 

[exec] Using default port 3920 for 1 1 OP_MUTUnLnUTH . 

[exec] Using default port 8686 for JMX_flDhlN. 

[exec] Donain being created with prof ile:developer„ as specified by variable AS_ADHIN_PROFI LE in configuration file 

[exec] The file in given locale [fr_FR] at; [F;\Too le\GlaeeFich\glacef ich— v2ur2— b04SlibSinctall\tenplatec\localec\f 
r_FR\index.html] could not be found. Using default <en_US> index. htnl instead, 
[exec] Security Store uses: JKS 
[exec] Donain donainl created. 

[exec] fldnin login information for hoct [localhoet] and port [4848] ic being overwritten with credentials provided. 
This is because the — savelogin option was used during create-donain connand. 

[exec] Login information relevant to admin user name [admin] for this donain [donainl] stored at [C:\Documents and 
Sell iny ii\An luii iu'\ . as admin pass 1 suuwssf ully . 

[exec] Hake sure tbat this file remains protected. Information stored in this file will be used by as admin commands 
to manage this donain. 

[de lete ] De let iny : F:\Tools\GlassFish\glassf ish-v2ur2-b04\passf ile 

BUILD SUCCESSFUL 



Figure 3-7 Configuration de GlassFish 



La configuration s'effectue avec succes lorsque le message build successful 
s'affiche sur l'ecran. II faut alors positionner la variable GLASSFISH_HOME (par 
exemple, set GLASSFISH_HOME=F : \Tool s\Gl assf i sh\gl assf i sh-v2ur2-t>04) 
et rajouter le repertoire bin dans la variable systeme PATH (pour notre 
exemple : PATH=%GLASSFISH_HOME%\bi n ;%PATH%) (figure 3-7). 

Pour verifier que l'installation s'est bien deroulee, demarrez le domaine 
par defaut (domai nl) de GlassFish en tapant la commande suivante : 

asadmin start-domain domai nl 

Avec votre navigateur, rendez-vous a l'adresse http://localhost:8080. Si vous 
voyez la page d'accueil par defaut s'afficher, e'est que votre serveur fonc- 
tionne (figure 3-8). 



i System ApuliudUun Server - Server Ru 



Fichier Edition Affichage Historigue Margue-pages Outils 



i, 



• & £J Li http ; f/localhost:8080; 



Your Application Server is now running 

Tn replarp this pagp, nvprwritp thp flip indRv ht.ml in Ihp rinmmpnt rnnt fnlHpr nf this domain's ripfault virtual 
sprvpr Thp dnrnmpnt rnnt tnlrlpr nf Ihp rinmain Hnmai n1 is Innatprl at install-dir 
/do»ains/do»ainl/doer-oot, where install-dir is the Application Server installation directory. 

Register the Application Server with Sun Connection now 

Use the Admin Console to register the Application Server with Sun Connection now. Registration Is optional, but 
us a registered user yuu receive benefits such as. 

• Patch information and bug updatcc 

• Screencasts and tutorials 

• Ncwc and cvontc 

• Support and training offerings 

Get a Sun Java System Application Server subscription 

To benefit from powerful support for the commercial counterpart to GlassFish, the Sun Java™ System Application 
Server, consider a Java System Application Server Subscription. This subscription provides a one-stop shop for 
products and services with immediate web access to software support with full indemnification, updates and 
upgrades, production and code support, training, and much more. 



Figure 3-8 

Page d'accueil par defaut de GlassFish 



Pour arreter le serveur par defaut domai nl, tapez la commande : 
asadmin stop-domain domai nl 

En parcourant l'arborescence des repertoires d'installation de GlassFish, 
on s'apercoit que la base de donnees Derby se trouve dans 
%GLASSFISH_HOME%\javadb. 



Outils Versions utilisees 

Pour le developpement de I'application YAPS 
Pet Store, voici la version des outils utilises dans ce 
livre : 

• JDK1.5J5 

• Ant 1.7 

• GlassFish V2ur2-b04 



Configuration du serveur GlassFish 

Nous venons d'installer les outils indispensables pour developper et exe- 
cuter I'application YAPS Pet Store. II nous faut encore configurer Glass- 
Fish pour repondre aux besoins specifiques de I'application. 

L'utilitaire asadmin 

La configuration de GlassFish peut se faire soit par une interface gra- 
phique, soit en ligne de commande via l'utilitaire asadmin. Celui-ci est 
fourni avec GlassFish (dans %GLASSFISH_HOME%\bi n) et vous permet 
d'administrer les composants du plus simple (file d'attente JMS, sources 
de donnees) au plus complexe (clustering, haute disponibilite). 
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GLASSFlSH Administration avec asadmin 

Pour faciliter la configuration du serveur GlassFish, 
les commandes asadmin seront incorporees 
dans des riches Ant. Ainsi, vous n'aurez pas a 
saisir les commandes mais plutot a utiliser les 
taches se trouvant dans le fichier admi n . xml . 
Celui-ci est teiechargeable sur le site 
► http://www.antoniogoncalves.org 



asadmi n peut s'utiliser de deux manieres : 

• en mode ligne de commande : on invoque asadmi n en lui passant des 
parametres (par exemple, asadmin ping-connection-pool --user 
admin --host localhost --port 8282 petstorePool) ; 

• en mode shell : en executant asadmi n sans parametre, on se retrouve 
dans un systeme de shell (reconnaissable a l'invite asadmi n>) oil Ton 
peut alors executer tous types de commandes et les enchainer (par 
exemple, ping-connection-pool --user admin --host localhost 
--port 8282 petstorePool). 

asadmin est un utilitaire extremement riche, mais on peut facilement 
obtenir de l'aide generale en utilisant la commande asadmin help, ou 
particuliere a une commande (par exemple, asadmin help ping- 
connection-pool). Cerise sur le gateau, asadmin comporte un systeme de 
suggestion de commande. Ainsi, si vous recherchez une commande qui 
agit sur la base de donnees {database) mais que vous ne vous souvenez 
plus de son nom, vous pouvez simplement taper asadmin database. 
L'utilitaire vous proposera alors les commandes start-database et stop- 
database (voir figure 3-9). 



Figure 3-9 

Aide en ligne de la commande asadmin 



c\ Open JEE5 - asadmin 




asadmin> database 




CLI147 Invalid command,, database 




Closest matching command<s>: 


■ 


start -database 




stop-database 




Use "help" command for a list of valid commands. 




asadmin > 





Creation d'un domaine 



GlassFish Les mots de passe 

Pour administrer GlassFish il faut, soit saisir le mot 
de passe administrateur a chaque commande en 
ligne, soit le stacker dans un fichier. Cette 
deuxieme solution a ete adoptee dans ce livre. 
Vous trouverez done dans le code de YAPS 
Pet Store le fichier passwordfi 1 e qui contient 
le mot de passe administrateur sous le format : 
AS_ADMIN_PASSWORD=admi npwd 



Tout d'abord, nous allons creer un domaine propre a Implication. 
Comme nous venons de le voir lors de l'installation, GlassFish possede 
un domaine par defaut qui se nomme domainl. Nous allons creer un 
domaine specifique a YAPS Pet Store que nous nommerons petstore. 
Pour cela, tapez la commande suivante : 

asadmin create-domain --adminport 8282 --user admin -- 
savemasterpassword=true --i nstanceport 8080 petstore 

L'utilitaire asadmin vous demande alors de saisir un mot de passe pour 
l'administrateur et un mot de passe pour le master. Pour simplifier 
l'administration de GlassFish, utiliser admi npwd pour l'administrateur et 
masterpwd pour le master. 
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B OpenJEE5 HE 



F:\>acadrtin create-rtonain — adninport 8282 — ucer adnin — cavenacterpaccvtord^true — inccanceport 8080 petctore 
Please enter the admin password) 
Pleace enter the adnin password again> 

Plnasa enter the Mttep paaaword lEntar tn aecaac thm Jaf aaltll) 

Pleace enter the naeter pace word again [Enter to accept the default l:> 

II* in u fart fur Main. 

Ucinq port 8080 for HTTP Instance. 

Iking Satan It port 7f,76 fur .IMS. 

Doing default port 3700 for HOP. 

Ilxlng dafault part fllfil f..r HTTP_SSI.. 

Joing default port 3820 for IIOP.SUL. 

Using iWfflL.lt pun. 3920 fur 1I0P_HUTUALAUTH. 

Joing default port tihVb for JPIXJIDHIN. 

Dunaid baing iradi«J with pi-uf il* : dirvv lup^r, u * par if lad by uariabltr AS_ADr1I N_PR0FI LE in confiaiuMtivn file. 

1 he f ile in given locale lf"r_FKJ at : IF :Mooi3\Cla33i-'i3h\gla33t i3h-vUur2-bH4\libNin3tall\tcroplatc3\localc3Nfr_!'KSindcx.h 

tnll could not be found. Using default (en_US> index. htnl instead. 

Security titorc Mill JKt> 

Dona In petstore created. 



Figure 3-10 

Configuration 

du domaine Pet Store 



Cela a pour effet de creer un domaine intitule petstore qui ecoute sur le 
port 8080. Le port d'administration est le 8282. Vous trouverez done le 
nouveau sous repertoire %GLASSFISH_HOME%\domains\petstore. 

La commande asadmin create-domain que nous venons d'utiliser est la 
seule qui ne soit pas encapsulee dans une tache Ant. Pour les com- 
mandes qui suivent, vous devez telecharger le code de 1' application et 
utiliser le fichier admi n . xml . 



GlassFish Comprendre les domaines 

GlassFish, comme bien d'autres serveurs duplica- 
tions, utilise le concept de domaines. Un domaine 
est une instance de serveur contenant ses propres 
fichiers de configuration. On peut ensuite y 
deployer plusieurs applications. 



Demarrage du domaine 

Pour configurer un domaine, le serveur doit etre demarre. Pour cela, 
demarrez l'instance petstore a l'aide de la commande : 

| %PETST0RE_H0ME%\> ant -f admin. xml start-domain 

Assurez-vous que l'instance fonctionne en vous rendant a l'adresse http:// 
localhost:8080. Pour acceder a la console d'administration, allez a l'adresse 
http://localhost:8282 puis saisissez le nom de l'utilisateur admin et son mot 
de passe adminpwd. Pour arreter l'instance, tapez la commande suivante : 



Telecharger YAPS Pet Store 



Telechargez le code de I'application, decom- 
pressez le fichier dans un repertoire et positionnez 
la variable PETST0RE_H0ME. 
► http://www.antoniogoncalves.org 



%PETSTORE_HOME%\ant -f admin. xml stop-domain 



GlassFish Les ports d'ecoute 

GlassFish utilise plusieurs ports d'ecoute par defaut 
pour traiter des requetes ou des protocoles : 

• 3700 : MOP ; 

• 3829 : MOP securise ; 

• 4848 : console d'administration ; 

• 8080 : HTTP ; 

• 8181 : HTTPS; 

• 8686 : JMX. 

II est possible de creer plusieurs domaines sur un meme 
serveur. Si tel est le cas, pour executer ces domaines en 
parallele, les ports d'ecoute par defaut doivent etre 



modifies (un port ne peut etre utilise que par un seul 
process). Au lieu de les changer un par un pour chaque 
domaine, la commande asadmin create-domain 
permet de les modifier tous a la fois a partir d'un 
nombre de base. II suffit d'utiliser le parametre - 
portbase et le domaine est alors cree avec les regies 
suivantes : 

• console d'administration = portbase + 48 ; 

• port HTTP = portbase + 80 ; 

• port MOP = portbase + 37 ; 

• port JMX = portbase + 86. 

asadmin create-domain -portbase 1000 --user admin 
--savemasterpassword=true petstore 
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Ant Tache setup 



Toutes les taches de configuration que nous allons 
voir, sont regroupees dans la tache setup. Ainsi, 
au lieu de les taper toutes une a une, vous pouvez 
utiliser : 

ant -f admin. xml setup 



Pool de connexions 



Un pool de connexions est un mecanisme permet- 
tant de reutiliser les connexions a la base de don- 
nees. Comme la creation d'une nouvelle connexion 
JDBC consomme beaucoup de ressources, il est 
plus judicieux d'utiliser un pool qui reutilise les 
connexions libres. 



Configuration de la base de donnees 

Apres avoir cree un domaine specifique a l'application YAPS Pet Store, 
nous allons en faire de meme pour la base de donnees Derby. Pour cela, 
il nous faut tout d'abord la demarrer a l'aide de la commande : 

| %PETSTORE_HOME%\> ant -f admin. xml start-db 

Vous verrez alors apparaitre un ecran affichant les parametres de Derby. 
Pour arreter la base de donnees, tapez la commande suivante : 

| %PETSTORE_HOME%\> ant -f admin. xml stop-db 

Creation d'un pool de connexions 

Dans un premier temps, nous allons creer un pool de connexions dans le 
serveur GlassFish (pour les taches qui vont suivre, GlassFish et la base 
de donnees doivent etre demarres). Pour cela, utilisez la commande : 

J %PETSTORE_HOME%\> ant -f admin. xml create-connection-pool 
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Figure 3-11 

Affichage du pool 
de connexions dans la 
console d'administration 
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Cela a pour effet de creer le pool de connexions petstorePool avec l'uti- 
lisateur dbuser et le mot de passe dbpwd. Pour verifier que le pool est bien 
cree, vous pouvez soit utiliser la commande : 

| %PETST0RE_H0ME%\> ant -f admin. xml list-connection-pool 

soit utiliser la console d'administration (http://localhost:8282). Pour cela, 
naviguez dans l'arborescence du menu de droite et deployez les noeuds 
Resources, JDBC, Connection Pools. Vous verrez alors apparaitre le pool 
petstorePool (figure 3-11). 

Creation de la base de donnees 

Pour creer la base de donnees, nous utiliserons la flexibilite de Derby. En 
effet, il suffit de « pinger », c'est-a-dire lancer une commande pi ng sur le 
pool de connexions pour creer la base petstoreDB. Cette commande ping 
peut etre faite soit via la console d'administration (cliquez sur le bouton 
Ping de l'ecran precedent), soit par la commande suivante : 

| %PETSTORE_HOME%\> ant -f admin. xml ping-connection-pool 

Vous verrez alors apparaitre le nouveau repertoire %GLASSFISH_HOME%\ 
javadb\petstoreDB ou Derby stockera les donnees de l'application YAPS 
Pet Store. Pour acceder a cette base, utilisez le meme utilisateur et mot de 
passe que celui defini dans le pool de connexions precedent (dbuser/dbpwd). 

Creation d'une source de donnees 

Apres le pool de connexions, il nous faut creer une source de donnees 
(DataSource). Comme nous le verrons au chapitre suivant Objets persis- 
tants, c'est cette source de donnees qui est referencee dans le code de 
l'application. Pour la creer, utilisez la commande : 

| %PETST0RE_H0ME%\> ant -f admin. xml create-datasource 

Pour verifier que la source de donnees a bien ete creee, vous pouvez soit 
utiliser la commande : 

| %PETST0RE_H0ME%\> ant -f admin. xml 1 ist-datasource 

soit utiliser la console d'administration (http://localhost:8282). Pour cela, 
naviguez dans l'arborescence du menu de droite et deployez les noeuds 
Resources, JDBC, JDBC Resources. Vous verrez alors la DataSource jdbc/ 
petstoreDS (figure 3-12). 



A Une source de donnees 

Une source de donnees {Data Source) propose de 
fournir une meilleure alternative a la classe 
Dri verManager pourfaciliter I'obtention d'une 
connexion a une base de donnees. Agissant comme 
une fabrique (factory), elle permet au serveur de 
controler le cycle de vie d'une connexion, [.'utilisa- 
tion d'un objet DataSource est obligatoire pour 
pouvoir utiliser un pool de connexions dans un ser- 
veur Java EE. 
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Figure 3-12 

Affichage de la source de 
donnees dans la console 
d'administration 
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Creation des ressources JMS 

L'application YAPS Pet Store utilise JMS pour les traitements asyn- 
chrones. II faut done creer une fabrique de connexions ainsi qu'un Topic 
(file d'attente) JMS. Pour cela, tapez les commandes suivantes : 

%PETSTORE_HOME%\> ant -f admin. xml create- jms-connection-factory 
%PETSTORE_HOME%\> ant -f admin. xml create- jms-topic 

Pour verifier que toutes ces ressources ont bien ete creees, tapez les com- 
mandes suivantes : 

| %PETSTORE_HOME%\> ant -f admin. xml 1 ist- jms-resources 

Vous pouvez aussi utiliser la console d'administration (http:// 
localhost:8282). Pour ce faire, naviguez dans l'arborescence du menu de 
droite et deployez les noeuds Resources, JMS Resources. Vous verrez les 
deux sous-menus Connection Factories (contenant la fabrique jms/ 
petstoreConnectionFactory) et Destination Resources (contenant la file 
d'attente jms/topic/order), voir figure 3-13. 
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Figure 3-13 

Affichage des resources 
JMS dans la console 
d'administration 



Creation de loggers 

Pour nous aider a deboguer 1' application ou a suivre l'enchainement de 
methodes, nous utiliserons l'API de logging de Java. Pour cela, il nous 
faut creer differents loggers pour pouvoir consulter les traces dans la 
console de GlassFish : 



Tableau 3-1 Loggers 



Nom du logger 




com.yaps.petstore 


Traces de I'application YAPS Pet Store 


com.barkbank.validator 


Traces du service web de validation de carte bancaire de BarkBank 


com.petex.transport 


Traces du service web du transporter PetEx 



Ces loggers nous permettent d'ajouter des traces dans notre code et de 
les visualiser dans le fichier de log qui se trouve dans le repertoire 
%GLASSFISH_HOME%\domai ns\petstore\1ogs. On les cree a l'aide de la 
commande suivante : 

I %PETST0RE_H0ME%\> ant -f admin. xml set-loggers 
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Figure 3-14 

Affichage des loggers 
en criticite Finest 



m 

I Fichor 



;J!;jJ. 



System Application Server 9.1 02 Admin Console Mozilla Fircfox 



Fichier Editon Athchaqc Htstonquc Marque pages Oobls 



1 antonicaoncolvcs 



3 



hmr VVi iiii 

User; admn Uomain: petstore Server: locaiwet 

Sun |ava~ System Application Server Admin Console 



I F^f Common Tasks 
Registration 

j£ Web services 



[jg 'Cu:icTi 
h Keeourcae 
► j$jC..<fi.j.jrrfk.. 



J1A 
JTS 



INFfl 
INFO 
INFfl 
INFO 



NhU 



iNrn 



(■.•uni-aunjw) 
v (iavax cntcrproc resource jlo; ) 

v ( lavax.enterproe system container eumdo; ) 



v I oracle tc$>»Keeeen1iats;(avaxenterpnee resource.^ ) 
~^fjawax.ertcfprise;) 
v ( Javax .enterprise .system .weoser vices .saaJi j 



Verifier 

Web Container 



v fi^x cntcrproc 3y3tcm; ) 

v ()avax enterprise system-Wit, > 

,Vi' ( jofvox cntcrproc 3 vatcm toob verifier: ) 

V (jwuHi hiIh|*kh xy?d«ii i:iiimin well, my fl|ra:hn i;Jf*iin, ii 





1— 






FIPJ-ST 


G compeiex 


FINEST 


D com yaps peUtoie 


"""" 1 



Retour d'experience Les traces applicatives 

Depuis le JDK 1.4, il existe une API de logging (paque- 
tage java.util .logging). Cette API consiste a pister les 
traces des evenements survenus dans un systeme ou 
dans une application. Un ou plusieurs fichiers de log au 
format predefini sont generes en cours d'execution et 
conservent des messages informant sur la date et 
I'heure de I'evenement, la nature de ce dernier ainsi 
que sa gravite par un code ou une description seman- 
tique et eventuellement d'autres informations (utilisa- 
teur, classe, etc). 

Pour logger un message, il faut utiliser les methodes de 
I'objet java. uti 1 . loggi ng . Logger. L'argument Level 
definit le niveau de criticite du message passe en para- 
metre. Si ce niveau est gere, le message sera redirige 
vers tous les flux de sortie associes au journal. II existe 
plusieurs niveaux : 
• SEVERE : niveau le plus eleve. 



• WARNING : avertissement. 

• INFO : information. 

• CONFIG : configuration. 

• FINE : niveau faible. 

• FINER : niveau encore plus faible. 

• FINEST : niveau le plus faible. 

Par exemple, pour logger le message « donnee 
invalide » avec un niveau de criticite avertissement, on 
utilise le code : 

logger. log(Level .WARNING, "donnee invalide"); 
Cette API permet aussi d'eviter I'utilisation de la 
methode pri ntStackTrace d'une exception. Bien que 
tres utile, cette methode affiche la trace d'une excep- 
tion a I'ecran, sans la garder dans un fichier. En utilisant 
la methode throwing de I'API de logging, la trace de 
I'exception pourra etre repertories comme un message, 
e'est-a-dire dans un fichier ou sur la console. 
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Pour verifier que les loggers ont bien ete crees, utilisez la console 
d'administration (http://localhost:8282). Selectionnez le menu Application 
Server puis cliquez sur les onglets Logging et Log Levels. En bas de la 
page, vous trouverez la section Additional Module Log Level Properties ou 
vous verrez apparaitre les noms des loggers (figure 3-14). 

Recapitulatif des elements de configuration 

Nous venons de voir comment configurer le serveur GlassFish et les dif- 
ferents composants qui seront utilises par l'application. Le tableau ci- 
apres nous donne un recapitulatif de cette configuration. 



Tableau 3-2 Configuration GlassFish 





Description 


petstore 


Nom du domaine GlassFish utilise par l'application 


http : //l ocal host : 8080 


URL de l'application 


htpp : //l ocal host : 8282 


URL de la console d'administration 


admi n/admi npwd 


Login et mot de passe pour acceder a la console d'administration GlassFish 


master/masterpwd 


Login et mot de passe du super utilisateur GlassFish 


petstoreDB 


Nom de la base Derby oil seront stockees les donnees de l'application 


dbuser/dbpwd 


Login et mot de passe de la base de donnees 


petstorePool 


Nom du pool de connexions a la base 


petstoreDS 


Nom de la source de donnees pour acceder a la base 


jms/petsto reConnecti on Factory 


Fabrique JMS 


jms/topic/order 


File d'attente JMS pour la gestion des bons de commande 


com. yaps. petstore 


Nom du logger de l'application YAPS Pet Store 


com . barkbank . val i dator 


Logger du service web de validation de carte bancaire de BarkBank 


com . petex . t ransport 


Logger du service web du transporteur PetEx 



Environnement de developpement 

Tout au long de ce livre nous developperons trois applications : 

• YAPS Pet Store : le site de commerce electronique permettant 
d'acheter des animaux de compagnie ; 

• BarkBank : composant de validation des cartes bancaires ; 

• PetEx : application permettant au transporteur de livrer les animaux 
domestiques aux differents clients. 

Ces applications auront des arborescences differentes et seront deployees 
dans des fichiers .ear (ou .war) separes. 



A Les fichiers .ear 

Le fichier .ear (Enterprise Archive) est une 
archive au format JAR qui contient tous les fichiers 
d'une application Java EE (classes Java, EJB, pages 
web, images...). Les fichiers .ear sont deployes 
et executes par les serveurs d'applications. 
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Les repertoires 

Vous pourrez utiliser FIDE de votre choix pour developper ces applica- 
tions. Cependant, afin utiliser les taches Ant, il faudra respecter l'arbo- 
rescence des differents repertoires. La racine se trouve dans le repertoire 
%PETSTORE_HOME%. 

Tableau 3-3 Repertoires des applications 

nacrrintinn 



& BarkBank 
i- CD build 
i- CD classes 
(B- 1 i generated 
IB- Eg resources 
Q- &src 

B- S3 com. barkbank. validator 
&> C3 WEB-INF 


Le code de I'application BarkBank se trouve dans le repertoire %PETSTORE_HOME%\BarkBank. Vous y 

trouverez les sous-repertoires suivants : 

build : contient le fichier .war a deployer dans GlassFish ; 

cl asses : repertoire contenant le bytecode des classes de I'application ; 

generated : classes Java generees pour les services web ; 

resou rces : pages web et images du site de BarkBank ; 

s re : ce repertoire contient les fichiers source Java de I'application de validation des cartes bancaires. Les 
classes sont sous le paquetage com . barkbank. val i dator ; 
WEB-INF : les fichiers de configuration de I'application web. 


& PetEx 
l±l- CD build 
i- CD classes 
IB- CD generated 
(B- Eg resources 
S- &src 

IB- S3 com. petex. transport 
ffl- E3 WEB-INF 


Le code de I'application PetEx se trouve dans le repertoire %PETSTORE_HOME%\PetEx. Vous y trouverez 
les sous-repertoires suivants : 

build : contient le fichier .war a deployer dans GlassFish ; 

cl asses : repertoire contenant le bytecode des classes de I'application ; 

generated : classes Java generees pour les services web ; 

resou rces : pages web et images du site de PetEx ; 

sre : ce repertoire contient les fichiers source Java de 1 application du transporteur. Les classes sont sous 

le paquetage com. petex. transport ; 

WEB-INF : les fichiers de configuration de I'application web. 


ESYaps 
i- CD build 
i- CD classes 
IB- CD config 
(B- CD generated 
IB- Eg resources 
S- &src 

IB- S3 com.yaps.petstore 
B- Ci WEB-INF 


Le code de I'application YAPS Pet Store se trouve dans le repertoire %PETSTORE_HOME%\Yaps. Vous y 

trouverez les sous-repertoires suivants : 

build : contient le fichier . ear a deployer dans GlassFish ; 

cl asses : repertoire contenant le bytecode des classes de I'application ; 

conf i g : contient les fichiers de parametrage de I'application ; 

generated : classes Java generees pour les services web ; 

resou rces : pages web et images du site YAPS Pet Store ; 

s rc : ce repertoire contient les fichiers source Java de I'application YAPS Pet Store. Les classes sont sous le 

paquetage com . yaps . petstore ; 

WEB-INF : les fichiers de configuration de I'application web. 




A la racine, vous trouverez les deux fichiers des taches Ant : 

admi n . xml : toutes les taches d'administration du serveur GlassFish sont regroupees dans ce fichier. 
bui 1 d . xml : taches pour compiler et deployer les applications. 



Element 
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En resume 



Ce chapitre nous a presente les outils utilises pour le developpement de 
l'application YAPS Pet Store, c'est-a-dire Ant, le JDK, le serveur 
d'applications GlassFish et la base de donnees Derby. Nous les avons 
installes puis configures pour repondre a nos besoins techniques. Les 
developpements peuvent done commencer. 



chapitre 
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Objets persistants 



Nous commencerons les developpements par la couche 
de persistance. Apres avoir presente brievement ce concept, 
ce chapitre se concentre sur JPA (Java Persistence API). 
II decrit les annotations elementaires du mapping objet- 
relationnel et les annotations avancees (relations, jointures, 
cascades, etc.). A partir de l'etude de cas abordee dans 
le premier chapitre, nous definirons et implementerons 
les entities de l'application YAPS Pet Store. 



SOMMAIRE 

► Couche de persistance 

► JPA et les entities 

► Cycle de vie des entities 

► Mapping objet-relationnel 

► Les relations 0:1, 1:1 et 1 :n 

► Les objets persistants 
de l'application 

► Schema de la base de donnees 

MOTS-CLES 

► JDBC 

► JPA 

► Entity 

► Annotations 

► Relations 

► Mapping 0-R 

► DDL 



La persistance des donnees 



A JVM 



La machine virtuelle Java est une surcouche logi- 
cielle specifique a chaque systeme d'exploitation 
pour interpreter le code Java. 



Le langage Java instancie des objets en memoire et les manipule au tra- 
vers de methodes modifiant ainsi leur etat. Cet etat nest cependant 
accessible que lorsque la JVM (Java Virtual Machine) s' execute : si celle- 
ci s'arrete, le contenu de la memoire disparait ainsi que les objets et leur 
etat. L'un des fondements de la programmation consiste a reutiliser ces 
donnees. On appelle cela la persistance des donnees. 

La persistance est ainsi le fait d'exister dans le temps. Un objet qui reste 
en l'etat lorsqu'il est sauvegarde, puis recharge plus tard, possede la pro- 
priete de persistance. Le langage Java, d'une part, et certains fra- 
meworks, d'autre part, nous permettent de rendre persistants les objets 
de differentes manieres. 



La serialisation 



A SQL 



Structured Query Language (SQL), traduisez 
langage structure de requetes, est un langage des- 
tine a interroger une base de donnees. 



//, Le design pattern DAO 

Le design pattern DAO, {Data Access Object), est 
frequemment utilise pour simplifier la programma- 
tion avec JDBC. II permet de deleguer la persistance 
d'un objet metier vers un objet DAO. Ce dernier 
peut utiliser une base de donnees, un fichier texte, 
une base objet ou meme un serveur LDAP. 
Compose de trois objets, I'interface, la fabrique (ou 
Factory) et I'implementation, le design pattern 
DAO propose des methodes pour manipuler les 
donnees (recuperations et modifications). 



Au travers du mecanisme de serialisation, Java fournit une methode 
simple, transparente et standard pour realiser la persistance. Le format 
utilise etant independant du systeme d'exploitation, un objet serialise sur 
un systeme peut etre reutilise par un autre systeme. 

Les objets peuvent etre serialises sur le disque dur ou sur le reseau 
(Internet compris). Pour qu'un objet soit serialisable, il doit implementer 
I'interface java.io.Se realizable et posseder des attributs serialisables : 
Java saura alors comment rendre l'objet persistant. 

Ce mecanisme, bien que tres simple et directement utilisable par le lan- 
gage Java, est rarement employe pour des applications d'une certaine 
envergure. II n'offre ni langage de requete, ni d'infrastructure profession- 
nelle permettant la resistance aux fortes charges. 

JDBC 

JDBC (Java Data Base Connectivity) est la couche logicielle standard 
offerte aux developpeurs pour acceder a des bases de donnees relation- 
nelles. Elle se charge de trois etapes indispensables a l'acces aux donnees : 

• la creation d'une connexion a la base ; 

• l'envoi d'instructions SQL ; 

• l'exploitation des resultats provenant de la base. 

Cette API fait partie integrante de la plate-forme Java depuis la version 
1.1 du JDK. Elle est representee par le paquetage java.sql. Bien 
qu'encore largement utilisee, elle a tendance a disparaitre au profit d'outils 
de mapping objet-relationnel. En effet, developper une couche d'acces aux 
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donnees avec JDBC, meme utilisee de pair avec le pattern DAO, est un 
travail fastidieux, repetitif, qui consomme beaucoup de temps. 



Mapping objet-relationnel 

Le principe du mapping objet-relationnel (ORM ou object-relational 
mapping) consiste a deleguer l'acces aux donnees a des outils ou fra- 
meworks externes. Son avantage est de proposer une vue orientee objet 
d'une structure de donnees relationnelle (lignes et colonnes). 

Les outils de mapping mettent en correspondance bidirectionnelle les 
donnees de la base et les objets. Pour cela, ils utilisent des mecanismes de 
configuration pour executer les requetes SQL. 

II existe plusieurs API et frameworks permettant de faire du mapping 
objet-relationnel : les entity beans 2.x, Hibernate, TopLink, JDO et 
JPA. Pour stacker les donnees de l'application YAPS Pet Store, le choix 
se porte logiquement sur JPA, la nouvelle API de persistance de Java 
Enterprise Edition. 



Persistance Hibernate 



Hibernate est un framework Open Source destine a 
gerer la couche d'acces aux donnees. Pour ceux 
d'entre vous qui connaissent ce framework, vous 
remarquerez que JPA s'en est tres fortement ins- 
pire. La grande nouveaute etant le systeme 
d'annotations qui permet de se passer de fichiers 
de configuration XML (fichier .hbm dans hiber- 
nate). On peut retrouver ce mecanisme en melant 
Hibernate et xDoclet. 

Depuis sa version 3.2, Hibernate est compatible 
avec JPA. 

► http://www.hibernate.org/ 

► http://xdoclet.sourceforge.net/ 



Java Persistence API 



La persistance des donnees en Java EE 5 a ete completement rearchitec- 
turee au travers de JPA (Java Persistence API). Alors que nous parlions 
de composants persistants en EJB 2.x (entity beans), JPA se recentre sur 
de simples classes Java (entities). En EJB 2.x, la persistance ne pouvait 
etre assuree qua l'interieur du conteneur alors qu'avec JPA, elle peut etre 
utilisee dans une simple application Java SE (Java Standard Edition). II 
fallait auparavant utiliser le mecanisme complet de creation des EJB 
pour obtenir un entity bean (au travers des interfaces Home, Local ou 
Remote) alors que maintenant on utilise tout simplement l'operateur new. 
Dans la version 2.x, les possibilites du mapping O-R etaient limitees 
alors qu'avec JPA on peut maintenant mettre en oeuvre les notions 
d'heritage et de multitable (les attributs d'un objet peuvent etre stockes 
dans plus d'une table). 

JPA est une abstraction au-dessus de JDBC et permet de s'affranchir du 
langage SQL. Toutes les classes et annotations de cette API se trouvent 
dans le paquetage javax. persi stence. 



EJB Les entity beans 2.x 



Pour vous faire une idee des modifications appor- 
tees a la specification EJB, retrouvez en annexe le 
code source d'un entity bean 2.1 . 



Persistance Implementations JPA 

Cet ouvrage utilise TopLink Essentials comme 
implementation de JPA, mais il en existe d'autres 
comme Hibernate, Kodo ou OpenJPA. Chacune de 
ces implementations se doit de suivre la specifica- 
tion, mais peut apporter quelques atouts specifi- 
ques, comme la gestion du cache, qui ameliore les 
performances. 

TopLink Essentials est ('implementation de refe- 
rence de JPA 1.0. 

► http://openjpa.apache.org/ 

► http://www.hibernate.org/ 

► http://www.oracle.com/technology/ 
products/ias/toplink/jpa/index.html 

► http://www.bea.com/kodo 
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//, Entity Bean et Entity 



Les EJB 2.x utilisent le terme d'entity bean pour 
definir les composants persistants. Avec JPA, on 
parle plutot tout simplement d'entity (ou entite). 



Entity 



Dans le modele de persistance JPA, un entity est une simple classe Java 
(Pojo). On declare, instancie et utilise cet entity tout comme n'importe 
quelle autre classe. Un entity possede des attributs (son etat) qui peuvent 
etre manipules via des accesseurs (methodes get et set). Grace aux 
annotations, ces attributs peuvent etre rendus persistants en base de 
donnees. 



Rappel Pojo 

Pojo est I'acronyme de Plain Old Java Object, 
que Ton pourrait traduire par « bon vieil objet 
Java ». 



Syntaxe Entity 



Un entity est une classe Java qui possede les carac- 
teristiques suivantes : 

• elle doit etre annotee par @Enti ty ; 

• elle doit avoir un identifiant annote par Old ; 

• elle doit etre publique ; 

• elle ne doit pas etre finale ; 

• elle peut implementer Se ri al i zabl e seule- 
ment si elle doit traverser des couches reseau ; 

• elle ne doit pas definir la methode 
fi nal ize ; 

• elle doit avoir un constructeur par defaut. 



Remarque Constructeur par defaut 

Une classe Java qui ne declare pas explicitement 
de constructeur possede tout de meme un cons- 
tructeur par defaut. 



Exemple d'entity 

Rien ne vaut un premier exemple simple d'entity pour expliquer le map- 
ping objet-relationnel. 

Exemple simple d'entity 

©Entity Q 

public class Address { 
@Id © 

private Long id; 
private String streetl; 
private String street2; 
private String city; 
private String state; 
private String zipcode; 
private String country; 
// Accesseurs get/set 

} 

Cet exemple de code represente une classe Address. Notez la presence 
d' annotations a plusieurs endroits dans la classe. Tout d'abord, l'annota- 
tion Ojavax. persistence. Entity Q permet a JPA de reconnaitre cette 
classe comme une classe persistante et non comme une simple classe Java. 
L'annotation @javax. persistence. Id Q, quant a elle, definit l'identifiant 
unique de l'objet. Elle donne a 1'entity une identite en memoire en tant 
qu'objet, et en base de donnees via une cle primaire. Les autres attributs 
(streetl, street2,... country) seront rendus persistants par JPA en appli- 
quant les parametrages par defaut : le nom de la colonne est identique a 
celui de l'attribut etle type String est converti en varchar(255). 

Cet exemple ne comporte que des attributs, mais la classe peut aussi avoir 
des methodes metier comme nous le verrons par la suite. Notez que cet 
entity Address est une simple classe Java (Pojo). Elle n'implemente aucune 
interface, se contente d'etre annotee par Ojavax. persistence. Entity et 
d' avoir un identifiant unique (@javax. persistence. Id). Pour etre un 
entity une classe doit au minimum utiliser ces deux annotations et pos- 
seder un constructeur par defaut. 
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Grace a ces annotations, JPA peut synchroniser les donnees entre les 
attributs de l'entity Address et les colonnes de la table Address. Ainsi, si 
l'attribut zi pcode est modifie par l'application, JPA se chargera de modi- 
fier cette valeur dans la colonne zi pcode. 

DDL de la table ADDRESS 

CREATE TABLE ADDRESS ( 



ID BICINT NOT NULL, 
CITY VARCHAR(255) , 
STATE VARCHAR(255) , 
STREET2 VARCHAR(255) , 
ZIPCODE VARCHAR(255) , 
STREET1 VARCHAR(255) , 
COUNTRY VARCHAR(255) , 

PRIMARY KEY (ID) 



Le nom de la table est identique a celui de la 
classe. 



Les attributs de la classe sont stockes dans des 
colonnes qui portent le meme nom que les attri- 
buts de l'entity. 



< L'attribut id est la cle primaire de la table. 



A DDL 



Le langage de definition de donnees (Data 
Definition Language ou DDL) permet de 
manipuler les structures de donnees et non les 
donnees elles-memes. Dans notre exemple, 
I'ordre Create Table cree la structure 
d'une table dans la base. 



Remarque Generation des DDL 

Les DDL peuvent, soit etre ecrites par un DBA 
(administrateur de base de donnees), soit etre 
generees automatiquement a partir des anno- 
tations JPA. Comme nous le verrons dans le 
chapitre 6, Execution de /'application, le 
cas decrit dans cet ouvrage utilise la genera- 
tion automatique. 



Annotations elementaires du mapping 



L'exemple simple de l'entity Address peut etre complete pour modifier 
certaines conventions de nommage (tables, colonnes) ou de typage 
(colonne non nulle, de longueur definie, etc.). Pour cela, il suffit d'uti- 
liser les attributs des annotations JPA. 

Table 

L'annotation @javax. persistence. Table permet de definir les valeurs 
par defaut liees a la table. Elle n'est pas obligatoire mais permet, par 
exemple, de specifier le nom de la table dans laquelle les donnees seront 
stockees. Si cette annotation est omise, le nom de la table sera le meme 
que celui de la classe. 



Annotations Les descripteurs XML 

Pour ceux qui sont habitues a utiliser des descrip- 
teurs XML en lieu et place des annotations, JPA 
vous laisse le choix. Cependant, cet ouvrage ne 
couvre pas les descripteurs XML et se concentrera 
sur les annotations. 
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Definir une annotation 



Les annotations sont definies par des meta-annotations. Par exemple, 
le code de I'annotation ©Tabl e que nous venons de voir, utilise plu- 
sieurs meta-annotations. 

©Target permet de limiter le type d'elements sur lesquels I'annota- 
tion peut etre utilisee. Si elle est absente de la declaration, elle peut 
alors etre utilisee sur tous ces elements : 

• ANNOTATION_TYPE : I'annotation peut etre utilisee sur d'autres 
annotations. 

• CONSTRUCTOR : I'annotation peut etre utilisee sur des construc- 
tors. 

• FIELD: I'annotation peut etre utilisee sur des champs d'une 
classe. 

• LOCAL_VARIABLE : I'annotation peut etre utilisee sur des varia- 
bles locales. 

• METHOD : I'annotation peut etre utilisee sur des methodes. 

Persister les donnees d'une classe dans plusieurs tables 

Par defaut, JPA suppose que tous les champs persistants d'un entity 
sont stockes dans une seule table. Cette table est connue comme la 
table primaire (annotation ©Tabl e). Dans certaines situations, vous 
pouvez souhaiter persister les donnees d'une classe dans une table 
primaire ainsi que dans une ou plusieurs tables secondaires. Pour 
cela, il faut employer I'annotation ©SecondaryTabl e pour asso- 
cier un Entity a une table secondaire ou ©SecondaryTabl es pour 
plusieurs tables secondaires. JPA persistera alors certains champs 
dans la table primaire et certains autres dans les tables secondaires. 
Dans ce cas, il faut associer les attributs a une des tables en utilisant 
I'annotation ©Col umn (que Ton verra dans les prochaines pages). 
Ci-dessous une classe Address persistant ses donnees dans une 
table primaire et deux tables secondaires : 
©Entity 

©Table(name = "t_address") Q 

©SecondaryTabl es({ 0 

©Secondary Tabl e(name="t_ci ty") , © 
©Secondary Tabl e(name="tcountry")Q 

}) 

public class Address { 
©Id 

private Long id; 
private String streetl; 0 
private String street2; 0 
©Col umn (tabl e="t_city") 
private String city; 0 
©Col umn (tabl e="t_ci ty") 
private String state; 0 
©Col umn (tabl e="t_city") 



• PACKAGE : I'annotation peut etre utilisee sur des paquetages. 

• PARAMETER : I'annotation peut etre utilisee sur des parametres 
d'une methode ou d'un constructeur. 

• TYPE : I'annotation peut etre utilisee sur la declaration d'un 
type : classe, interface (annotation comprise) ou enumeration. 

©Retention indique la maniere dont I'annotation doit etre geree 
par le compilateur. Elle peut prendre une de ces trois valeurs : 

• SOURCE : les annotations sont presentes dans le source mais ne 
sont pas enregistrees dans le fichier . cl ass. 

• CLASS : les annotations sont enregistrees dans le fichier . cl ass 
a la compilation mais elle ne sont pas utilisees par la machine vir- 
tuelle a I'execution de I'application. 

• RUNTIME : les annotations sont enregistrees dans le fichier 
. cl ass a la compilation et sont utilisees par la machine virtuelle 
a I'execution de I'application. 



private String zipcode; 0 
©Col umn (tab! e="t_country") 
private String country; 0 

// Accesseurs get/set 

} 

Par defaut, les attributs 0 de la classe Add ress sont persistes dans 
la table primaire t_address Q. L'annotation 
©SecondaryTables 0 signale a JPA qu'il existe deux tables 
secondaires : t_ci ty 0et t_country 0. II suffitensuite de spe- 
cifier a I'aide de I'annotation ©Col umn les attributs qui sont stockes 
dans t_ci ty 0 ou t_country 0. 

Le resultat est done la creation de trois tables contenant des attributs 
differents et une meme cle primaire. 
CREATE TABLE T ADDRESS ( 

ID BICINT NOT NULL, 

STREET1 VARCHAR(255), 

STREET2 VARCHAR(255), 

PRIMARY KEY (ID) 

) 

CREATE TABLE T_CITY ( 
ID BICINT NOT NULL, 
CITY VARCHAR(255), 
STATE VARCHAR(255), 
ZIPCODE VARCHAR(255), 
PRIMARY KEY (ID) 

) 

CREATE TABLE T COUNTRY ( 
ID BICINT NOT NULL, 
COUNTRY VARCHAR(255), 
PRIMARY KEY (ID) 

) 
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Code de I'annotation @javax.persistence.Table 

package javax. persistence; 

©Target ({TYPE}) ©Retention (RUNTIME) 

public ©interface Table { 

String name() default ""; 

String catalogO default ""; 
String schema() default ""; 

UniqueConstraint[] uniqueConstrai nts() default {}; 

} 

Ainsi, si nous voulions changer le nom de la table en t_address, nous 
devrions ecrire le code suivant : 

Entity Address persistant ses donnees dans la table t_address 

©Entity 

@Table(name = "t address") 

public class Address { 

©Id 

private Long id; 
private String streetl; 
// (...) 

} 



Cette annotation s'applique a une classe. 



Nom de la table. 



Identifie le catalogue et le schema de la base de 
donnees relationnelle. 



Ce tableau permet de definir les contraintes 
d'unicite sur une ou plusieurs colonnes. 



Clc primaire 

Comme nous l'avons vu precedemment, un entity doit avoir au 
minimum les annotations ©Entity et ©Id. ©javax. persistence. Id 
annote un attribut comme etant un identifiant unique. 

Code de I'annotation @javax.persistence.ld 

package javax. persistence; 

©Target ({METHOD, FIELD}) ©Retention (RUNTIME) 

public ©interface Id {} 

La valeur de cet identifiant peut etre, soit generee manuellement par 
l'application, soit generee automatiquement grace a I'annotation 
©javax. persistence. GeneratedVal ue. Trois valeurs sont alors possibles : 

• La generation de la cle unique se fait de maniere automatique (AUTO) 
par la base de donnees (valeur par defaut). 

• On utilise une sequence SQL (SEQUENCE) pour obtenir cette valeur. 

• Les identifiants sont stockes dans une table (TABLE). 



Cette annotation s'applique a une methode ou 
un attribut. 



L'annotation ©Id n'a pas de methode. 
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Cette annotation s'applique a une methode ou 
un attribut. 



La generation de la cle unique peut etre faite 
soit de maniere automatique (AUTO), soit en 
utilisant une sequence SQL (SEQUENCE) ou une 
table contenant les identifiants (TABLE). 



Code de I'annotation @javax.persistence.GeneratedValue 

package javax. persistence; 

©Target ({METHOD, FIELD}) @Retention(RUNTIME) 

public ©interface GeneratedVal ue { 

Gene rati onType strategyO default AUTO; 

String generatorO default ""; 

} 

Ci-apres le code de la classe Address avec une generation automatique 
de l'identifiant : 

Entit Address avec generation automatique d'identifiant 

©Entity 

@Table(name = "t_address") 
public class Address { 



©Id 

©CeneratedVal ue (strategy 

private Long id; 
private String streetl; 
// (...) 



Cenerati onType . AUTO) 



Annotations Attribut ou methode 

La plupart des annotations peuvent s'appliquer sur 
les attributs ou sur les methodes. Par exemple, 
I'annotation ©Id peut etre accolee a I'attribut id 
ou a la methode getld () . Dans cet ouvrage, par 
choix mais aussi pour faciliter la lecture, les anno- 
tations sont appliquees aux attributs et non aux 
methodes. 



Cette annotation s'applique a une methode ou a 
un attribut. 



Norn de la colonne. 



La valeur doit-elle etre unique ? 



La valeur nul 1 est-elle autorisee ? 



Autorise-t-on la colonne dans un ordre i nsert 
ou update ? 



Colonne 

L'annotation ©javax. persistence. Column definit les proprietes d'une 
colonne. On peut ainsi changer son nom (qui par defaut porte le meme 
nom que I'attribut), preciser son type, sa taille et si la colonne autorise ou 
non la valeur null. 

Code de I'annotation ©javax.persistence.Column 

package javax. persi stence ; 

©Target ({METHOD, FIELD}) ©Retention(RUNTIME) 

public ©interface Column { 

String name() default ""; 

boolean unique() default false; 

boolean nullable() default true; 

boolean insertable() default true; 
boolean updatableQ default true; 
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String columnDefinitionO default ""; 

String table() default ""; 
int lengthQ default 255 ; 



int precisionO default 0; 
int scaleO default 0; 

} 

Ainsi, pour redefinir les valeurs par defaut de l'entity Address, on peut 
utiliser l'annotation @Col umn de differentes manieres : 

Entity Address avec redefinition des colonnes 
©Entity 

©Table (name = "t address") 

public class Address { 

©Id 

©GeneratedVal ue(strategy = GenerationType.AUTO) 

private Long id; 

©Col umn (null able = false) 

private String streetl; 

private String street2; 



©Col umn (null able = false, length 

private String city; 

private String state; 



100) 



©Col umn (name = "zip code", null able = false, length = 10) 

private String zipcode; 

©Col umn (null able = false, length = 50) 

private String country; 

// accesseurs get/set 

public Long getld() {return id;} 

public String getStreetl() {return streetl;} 
public void setStreetl(Stri ng streetl) { 
this. streetl = streetl; 

} 

public String getStreet2() {return street2;} 
public void setStreet2(String street2) { 
this.street2 = street2; 

} 



Cet attribut peut contenir la definition de la 
colonne au format DDL. 



Utilise lors d'un mapping multitable. 



Longueur maximale pour une colonne de type 
Varchar. 



Pour les colonnes de type numerique, on peut 
rajouter la precision. 



< L'entity est stocke dans la table t_address. 



L'attribut id est I'identifiant de cet entity. Sa 
valeur est generee automatiquement par la base 
de donnees. 



L'attribut streetl ne peut etre nul 1 . 



L'attribut city ne peut etre null et sa lon- 
gueur maximale est de 100 caracteres. 



L'attribut zi pcode est mappe dans la colonne 
zi p_code de 1 0 caracteres de long. 



II n'y a pas de methode setld puisque ce n'est 
pas I'application qui genere I'identifiant mais la 
base de donnees. 



Accesseurs des attributs. 
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Remarque Un setter pour I'identifiant ? 

Notez que, dans notre exemple, il n'y a pas de 
methode setld(). En effet, I'identifiant est 
genere automatiquement grace a I'annotation 
©GeneratedVal ue. Nous n'avons pas besoin 
de pouvoir changer cette valeur. 



DDL obtenu pour cet entity 

CREATE TABLE T_ADDRESS ( 
ID BICINT NOT NULL, 
CITY VARCHAR(IOO) NOT NULL, 
STATE VARCHAR(255) , 
STREET2 VARCHAR(255) , 
ZIP_CODE VARCHAR(IO) NOT NULL, 
STREET1 VARCHAR(255) NOT NULL, 
COUNTRY VARCHAR(50) NOT NULL, 
PRIMARY KEY (ID) 

) 

Comme nous pouvons le constater, JPA permet de modifier la DDL de 
la table au travers des annotations. 



Alternative Mapping par XML 

Ce chapitre vous presente differentes annotations 
vous permettant de personnaliser un mapping 
objet-relationnel (changer le nom des tables, le 
nom des colonnes, leur type...). II faut savoir que 
toutes ces operations sont egalement realisables 
via une configuration XML. En fait, il vous est 
meme possible de panacher annotations et XML, 
sachant que le XML prendra le dessus sur les 
annotations. 

Le mapping XML n'est pas aborde dans cet 
ouvrage. 



Cette annotation s'applique a une methode ou 
un attribut. 



Trois types de dates possibles : DATE, TIME et 
TIMESTAMP (valeur par defaut). 



Annotations avancees 



Date et heure 

En Java, nous pouvons utiliser les classes java.util .Date ou 
java.util .Calendar pour representer une date ou une heure. Lors du 
mapping objet-relationnel, on peut specifier ce type grace a I'annotation 
@javax. persi stence .Temporal . Elle peut prendre trois valeurs possibles : 
DATE, TIME ou TIMESTAMP, qui est la valeur par defaut. 

Code de I'annotation @javax.persistence.Temporal 

package javax. persistence; 

©Target ({METHOD, FIELD}) ©Retention (RUNTIME) 

public ©interface Temporal { 
TemporalType valueQ; 



RETOUR d'experience Generer la base de donnees 

Avec JPA, il est possible d'utiliser trois approches pour gerer le map- 
ping entre objets et base de donnees. 

La premiere consiste a partir des entities pour generer le schema de 
la base (ce que nous faisons dans cet ouvrage). Cette option n'est 
possible que lorsque le projet n'a pas de base de donnees existante 
et qu'il est de petite taille. En effet, dans la plupart des gros projets, 
il y a un DBA (Database administrator - Administrateur de base de 
donnees) qui controle que la structure de la base repond aux con- 
traintes de performances exigees. II faut alors adapter le mapping. 



La deuxieme consiste a generer les entities a partir d'une base de 
donnees existante. On se retrouve alors avec un modele qui se cale 
tres bien sur les donnees, mais qui n'a plus grand chose d'objet (pas 
d'abstraction, parfois meme pas d'heritage). 
La troisieme approche, qui est la plus adoptee, consiste a ne rien 
generer mais a utiliser la puissance des annotations pour caler un 
modele objet sur un modele relationnel. Chaque monde a ses avan- 
tages et ses contraintes, ils doivent s'influencer le moins possible, et 
les outils de mapping sont justement la pour ca. 
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Ci-apres un extrait de code de la classe client avec un attribut date de 
naissance de type ©Temporal (Temporal Type. DATE). 

Entity Customer avec date de naissance de type ©Temporal 

@Entity 

©Table (name = "t_customer") 
public class Customer { 

Old 

©GeneratedVal ue(strategy = Gene rati onType .AUTO) 

private Long id; 

@Col umn (name = "date of birth") 

©Temporal (Temporal Type . DATE) 

private Date dateOfBirth; 
// (...) 

} 

Remarquez que dans cet exemple, l'attribut dateOf Bi rth (date de nais- 
sance) est annote deux fois. @Col umn permet de renommer la colonne en 
date_of_bi rth et ©Temporal de preciser le format DATE. Comme nous le 
verrons par la suite, il est courant d'annoter un attribut a l'aide de plu- 
sieurs annotations. 



Donnees non persistees 

Avec JPA, des qu'une classe est annotee persistante (@Entity), ses attri- 
buts sont tous automatiquement stockes dans une table. Si Ton veut 
qu'un attribut ne soit pas rendu persistant, on doit utiliser l'annotation 
©javax. persistence. Transient. 

Par exemple, l'age du client n'a pas besoin d'etre rendu persistant en base 
puisqu'il peut etre calcule a partir de la date de naissance. 

Entiy Customer avec un attribut Transient 

©Entity 

@Table(name = "t_customer") 
public class Customer { 
(...) 

©Column (name = "date_of_bi rth") 
©Temporal (Temporal Type . DATE) 

private Date dateOfBirth; 

©Transient 

private Integer age; 



Remarque Mot-cle Java transient 

Avant I'apparition des annotations, Java introdui- 
sait deja le mot-cle transient qui precise que 
l'attribut ne doit pas etre inclus dans un processus 
de serialisation et deserialisation. 



La date de naissance du client est mappee dans 
une colonne de type DATE. 



L'age du client n'est pas stocke dans la base de 
donnees, cet attribut est transi ent. 
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Annotations Markup 



Nous avons vu le code de differentes annotations 
qui possedent des methodes. ©Embedded et 
©Embeddable ne definissent aucune methode. 
Elles sont appelees annotations markup. 



Le bon de commande est stocke dans la table 
t_order. 



Notez que nous pouvons ne pas specifier la stra- 
tegic de generation de cle si on utilise la strate- 
gic par defaut (strategy 
Gene rati onType . AUTO). 



La classe Order englobe les attributs de la 
classe CreditCard en utilisant I'annotation 
©Embedded. 



La carte de credit n'est pas annotee par 
©Entity mais par ©Embeddabl e. Cela 
signifie que ses attributs se retrouvent dans la 
table de la classe englobante. 



Englober deux objets dans une seule table 

JPA permet d'englober les attributs de deux classes dans une seule table 
de maniere relativement simple. Ceci est particulierement utile lorsque 
les deux classes partagent le meme cycle de vie (par exemple, lorsqu'on 
supprime un bon de commande, les lignes de commande n'ont plus de 
raison d'exister). La classe englobee utilise I'annotation ©Embeddable 
alors que la classe englobante utilise ©Embedded. 

JPA permet d'englober les attributs de deux classes dans une seule table 
de maniere relativement simple. La classe englobee utilise I'annotation 
©Embeddabl e alors que la classe englobante utilise ©Embedded. 

Prenons 1' exemple d'un bon de commande (Order) que Ton regie a l'aide 
d'une carte bancaire (CreditCard). Ces deux classes peuvent etre englo- 
bees dans une seule et meme table (t_order dans notre exemple). 

Entity Order englobant I'entity CreditCard 

©Entity 

@Table(name = "t_order") 
public class Order { 

©Id 

©CeneratedValue 
private Long id; 

©Embedded 

private CreditCard CreditCard; 
(...) 

} 

L'entity CreditCard est englobable 
©Embeddable 

public class CreditCard { 

private String creditCardNumber; 
private CreditCardType credi tCardType ; 
private String creditCardExpDate ; 

} 

Remarquez que, sans ces annotations, les attributs de Order seraient 
stockes dans une table et les attributs de Credi tCart dans une autre. 
Void la DDL de la table des bons de commandes. 

DDL de la table t_order contenant les attributs des deux entities 



Attributs de la classe Order. 



CREATE TABLE T_ORDER ( 

ID BIGINT NOT NULL, 
ORDER_DATE DATE, 
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CREDIT_CARD_TYPE VARCHAR(255) , 
CREDIT_CARD_NUMBER VARCHAR(30) , 
CREDIT_CARD_EXPIRY_DATE VARCHAR(5) , 

PRIMARY KEY (ID)) 



< Attributs de la classe Credi tCard. 



< La cle primaire est cellede la classe Order. 



Relations 



Nous venons d'etudier toutes sortes d'annotations permettant de mapper 
une classe dans une table, un attribut dans une colonne et changer certaines 
valeurs par defaut. Le monde de l'oriente objet regorge aussi de relations 
entre classes (associations unidirectionnelles, bidirectionnelles, multiples, 
etc.). JPA permet de rendre persistante cette information de telle sorte 
qu'une classe peut etre liee a une autre dans un modele relationnel. 

II existe plusieurs types d'associations entre entities. Tout d'abord, une 
association possede un sens et peut etre unidirectionnelle ou bidirection- 
nelle (c'est-a-dire qu'on peut naviguer d'un objet vers un autre et inver- 
sement). Ensuite, cette association possede une cardinalite, c'est-a-dire 
que nous pouvons avoir des liens 0:1, 1:1, l:n ou n:m. Nous ne decrirons 
pas toutes les combinaisons possibles d'associations, mais juste celles uti- 
lisees dans l'application YAPS Pet Store. 

Dans notre modele, les classes sont reliees entre elles par des associations. 
Cette notion objet a son pendant dans le monde relationnel. JPA est done 
capable de mapper des associations entre objets en relation entre tables. 



//. Cle etrangere 



Une cle etrangere {Foreign Key) est un champ 
d'une table fille, permettant la jointure avec une 
table parent. 



Jointures 

Dans le monde relationnel, il existe deux manieres d'avoir une relation 
entre deux tables : en utilisant les cles etrangeres ou les tables de join- 
tures intermediaires. 

Par exemple, pour stocker le fait qu'un client possede une adresse, on 
peut soit avoir une cle etrangere dans la table du client, soit une table 
intermediate qui stockera cette information (figures 4-1 et 4-2). 



Client 



Adresse 



Identifiant 


Norn 


Prenom 


Cle etranqerel 


1 


Pierre 


Durand 


M 


2 


Paul 


Dupond 




3 


Jacques 


Dupont 





I Identifiant 


Rue 


Ville 


Pays 


10 


St Antoine 


Paris 


France 




Traversiere 


Bordeaux 


France 




Aliqre 


Paris 


France 



Figure 4-1 

Utilisation de cles etrangeres 
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Client 



Adresse 



Figure 4-2 

Utilisation 
d'une table intermediate 



Identifiant 


Norn 


Prenom 


1 


Pierre 


Durand 


2 


Paul 


Dupond 


3 


Jacques i 


1 [Hjpont 



V 



Table intermediare 



1 Id client 


Id adresse J 


1 ' 


10 ' 


2 


11 


3 


12 



Identifiant 


Rue 


Ville 


Pavs 


10 


St Antoine 


Paris 


France 


11 


Traversiere 


Bordeaux 


France 


i: 1 — -- 


Aliqre 


Paris 


France 
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Comme nous le verrons dans les chapitres suivants, JPA utilise les deux 
modes de stockage. Par contre, JPA masque completement cette imple- 
mentation puisque les classes, elles, utilisent le meme type d'association 
dans les deux cas. 



Annotations Programmation par exception 

Comme nous I'avons vu pour les annotations ele- 
mentaires, JPA utilise des valeurs et des parame- 
tres par defaut (programmation par exception) 
pour effectuer son mapping. Ainsi, si un attribut 
n'est pas annote, JPA utilisera les valeurs par 
defauts pour le rendre persistant. II en est de 
meme pour les relations. II est possible de ne pas 
utiliser I'annotation ©OneToOne si les parame- 
trages par defaut nous satisfont. 



L'annotation @OneToOne definit un lien 1-1 
entre le bon de commande et I'adresse de livrai- 



Pour respecter la cardinalite 1 :1 et rendre la rela- 
tion obligatoire, on utilise l'annotation 
©Joi nCol umn. On specifie alors que la cle 
etrangere ne doit pas accepter la valeur null 
(nullable=false). 



Relation unidirectionnelle 1:1 

Une relation unidirectionnelle 1:1 entre classes est un lien de 
cardinalite 1 qui ne peut etre accede que dans un sens. Prenons l'exemple 
du bon de commande et de I'adresse de livraison. Les cas d'utilisation 
definissent qu'un bon de commande doit posseder une et une seule 
adresse de livraison (cardinalite 1). II est important de naviguer du bon 
de commande vers I'adresse, par contre, il n'est pas utile de pouvoir navi- 
guer dans le sens inverse. Le lien est done unidirectionnel. JPA utilise 
l'annotation ©OneToOne pour definir ce type de lien. 

Relation unidirectionnelle 1:1 entre bon de commande et adresse 

©Entity 

@Table(name = "t_order") 
public class Order { 

Old ©GeneratedVal ue 

private Long id; 

©OneToOne 



©Joined umn (name = "address fk", nullable = false) 
private Address del i veryAddress ; 
(. ■ ■) 



Pour rendre un lien unidirectionnel, il suffit de ne pas avoir d'attribut Order 
dans la classe Address. Remarquez l'utilisation de l'annotation ©Joi nCol umn. 
Celle-ci est utilisee pour parametrer la colonne de la jointure (la cle etran- 
gere). Dans notre exemple, on renomme la colonne en address^fk au lieu 
de deliveryAddress (qui serait son nom par defaut). On rend la relation 
obligatoire en refusant la valeur null dans cette colonne. 
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Code de I'annotation @javax.persistence.OneToOne 

package javax. persistence; 

©Target ({METHOD, FIELD}) ©Retention (RUNTIME) 
public ©interface OneToOne { 

Class targetEntityO default void. class; 

CascadeType[] cascade() default {}; 

FetchType fetch() default FetchType. EAGER; 

boolean optional () default true; 
String mappedByO default ""; 

} 

Code de I'annotation @javax.persistence.JoinColumn 

package javax. persistence; 

@Target({TYPE, METHOD, FIELD}) ORetenti on (RUNTIME) 
public ©interface JoinColumn { 

String name() default ""; 

String referencedCol umnName() default ""; 

boolean unique() default false; 
boolean nullable() default true; 

boolean insertable() default true; 
boolean updatable() default true; 

String columnDefinition() default ""; 
String table() default ""; 

} 

Void le code DDL de la table t_order. La cle etrangere address_f k se trouve 
dans la table t_order et possede une contrainte d'integrite referentielle. 

DDL de la table t_order avec cle etrangere sur I'adresse 

CREATE TABLE T_0RDER ( 
ID BICINT NOT NULL, 
ADDRESS FK BICINT NOT NULL 

PRIMARY KEY (ID) 

) 

ALTER TABLE T_ORDER 

ADD CONSTRAINT T_ORDER_ADDRESS_FK 

FOREIGN KEY (ADDRESS FK) REFERENCES T ADDRESS (ID)} 



Norn de la classe de I'association. Dans notre 
exemple du bon de commande, 
targetEntity aurait pu etre egale a la 
classe Address. 



Les operations qui doivent etre propagees a la classe 
associee (decrit par la suite dans ce chapitre). 



Chargement de la relation (decrit dans la suite 
de ce chapitre). 



L'association est facultative. 



Cet attribut n'est utilise que dans un lien bidirec- 
tionnel. 



Cette annotation s'applique a une classe, une 
methode ou a un attribut. 



Norn de la colonne contenant la cle etrangere. 



Norn de la colonne referenced si ce n'est pas la 
cle primaire. 



La valeur doit-elle etre unique ? 



La valeur nul 1 est-elle autorisee ? 



Peut-on avoir la colonne dans un ordre i nsert 
ou update ? 



Cet attribut peut contenir la definition de la 
colonne au format DDL. 



Utilise lors d'un mapping multitable. 



La colonne address_fk n'accepte pas la 
valeur null , le lien est done obligatoire. 



A partir des annotations, JPA genere une con- 
trainte d'integrite referentielle entre la colonne 
address_fk de t_order et la cle primaire 
de la table t_address. 
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//. Contrainte d'integrite 

Permet de contraindre la modification des donnees d'une table, afin que les donnees saisies dans 
la base soient conformes aux donnees attendues. Dans le cas d'une cle etrangere, I'integrite 
referentielle s'assure que la cle etrangere existe dans la table references (add constrai nt). 



Pour rendre la relation optionnelle (0:1), on 
autorise la valeur null (valeur par defaut que 
Ton aurait pu omettre). 



La colonne address_fk accepte la valeur 
null, le lien est done optionnel. 



A partir des annotations, JPA genere une con- 
trainte d'integrite referentielle entre la colonne 
address_fk de la table t_customer, et la 
cle primaire de la table t_address. 



Relation unidirectionnelle 0:1 

Une relation unidirectionnelle 0:1 est implemented de la meme maniere 
qu'une relation 1:1. La seule difference reside dans le fait quelle est option- 
nelle. Prenons l'exemple d'un client et de son adresse. Dans les cas d'utilisa- 
tion, il est decrit qu'un client nest pas oblige de fournir son adresse au 
systeme. Par contre, si le client souhaite la saisir, il ne peut en avoir qu'une. 

Pour transformer une relation 1:1 en 0:1, il suffit d'autoriser la valeur 
null dans la colonne. Pour cela, il est necessaire de positionner l'attribut 
null able de l'annotation @JoinColumn a true. 

Relation unidirectionnelle 0:1 entre client et adresse 

©Entity 

@Table(name = "t_customer") 
public class Customer { 

Old OGeneratedValue 

private Long id; 

@0neTo0ne 

@JoinColumn(name = "address fk", nullable = true) 

private Address homeAddress ; 

(...) 



DDL d'une relation 0:1 entre t_customer et t_address 

CREATE TABLE T_CUST0MER ( 
ID BIGINT NOT NULL, 

ADDRESS FK BIGINT 

PRIMARY KEY (ID) 

) 

ALTER TABLE T_ CUSTOMER 

ADD CONSTRAINT T_CUST0MER_ADDRESS_FK 

FOREIGN KEY (ADDRESS FK) REFERENCES TJVDDRESS (ID)} 



Relation bidirectionnelle l:n 

Une relation l:n signifie qu'un objet fait reference a un ensemble 
d'autres objets (cardinalite n). Dans 1' application YAPS Pet Store, cette 
notion est decrite dans le catalogue, par exemple, ou une categorie con- 
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tient plusieurs produits. De plus, elle est bidirectionnelle puisque le pro- 
duit a connaissance de la categorie a laquelle il appartient. Cette 
information de cardinality en Java est decrite par les structures du paque- 
tage java.util : Collection, List, Map et Set. JPA utilise les annotations 
OOneToMany et @ManyToOne. 



Les collections en Java 



Les collections (paquetage java.util) proposent une serie de classes, 
d'interfaces et d'implementations pour gerer les structures de donnees 
(listes, ensembles). Chaque implementation utilise une strategie avec 
des avantages et des inconvenients : certaines collections acceptent les 
doublons, d'autres non ; certaines sont ordonnees, d'autres pas. 
Les java.util .Set (ensembles) sont un groupe d'elements uniques. 
Les java.util .List (listes) sont une suite d'elements ordonnes accessi- 
bles par leur rang dans la liste. Les listes ne garantissent pas I'unicite des 
elements. 

Les java.util .Map memorisent une collection de couples cle-valeur. Les 
cles sont uniques, mais la meme valeur peut-etre associee a plusieurs des. 



Une categorie possede une liste de produits 

©Entity 

@Table(name = "t_category") 
public class Category 
(...) 

@OneToMany(mappedBy = "category") 
private Li st<Product> products; 
(...) 

} 

Le produit a connaissance de sa categorie 

©Entity 

@Table(name = "t_product") 
public class Product 
(...) 

@ManyToOne 

@Joi nCol umn(name = "category_fk") 
private Category category; 
(...) 

} 

Dans une relation bidirectionnelle, JPA peut utiliser deux modes de 
jointure : le systeme de cle etrangere ou la table de jointure. Si aucune 
annotation nest utilisee, la table de jointure est le mode par defaut. On se 
retrouve alors avec une table (t_category_product par exemple) contenant 
deux colonnes permettant de stocker la relation entre categorie et produit. 



Les donnees de I'entity Category sont ren- 
dues persistantes dans la table t_category. 



Une (One) categorie possede plusieurs (Many) 
produits. Remarquez I'utilisation des generiques 
pour la liste de produits. 



Les donnees de I'entity Product sont rendues 
persistantes dans la table t_product. 



Plusieurs (Many) produits peuvent etre ratta- 
ches a une (One) meme categorie. 
On renomme la colonne de la cle etrangere en 
category_f k. 
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La table t_category ne porte pas I'informa- 
tion du lien avec t_product. 



La table t_product utilise une cle etrangere 
pour pointer vers la table t_category. 



Contrainte d'integrite referentielle sur la cle 
etrangere category_f k. 



Si ce mode par defaut n'est pas satisfaisant, il faut utiliser l'attribut 
mappedBy de 1' annotation ©OneToMany. Dans notre exemple, le fait que 
l'entity Category declare @OneToMany(mappedBy = "category") precise a 
JPA qu'il doit utiliser le systeme de cle etrangere. L'attribut mappedBy n'a 
de sens que dans une relation bidirectionnelle. 

DDL des tables t_category et t_product 

CREATE TABLE T_CATEGORY ( 
ID BIGINT NOT NULL, 
PRIMARY KEY (ID) 

) 

CREATE TABLE T_PR0DUCT ( 
ID BIGINT NOT NULL, 

CATEGORY FK BIGINT, 
PRIMARY KEY (ID) 

) 

ALTER TABLE T_PR0DUCT 

ADD CONSTRAINT T_PRODUCT_CATEGORY_FK 

FOREIGN KEY (CATEGORY FK) REFERENCES t_category (ID) 



Association multiple sans generique 

L'entity Category utilise les generiques pour la liste des produits. Grace 
aux generiques qui typent cette liste, JPA sait que la persistance doit se 
faire entre Category et Product. Si vous n'utilisez pas les generiques, 
JPA ne saura pas sur quel autre entity pointer. II faut alors specifier la 
classe de l'entity dans la relation a I'aide de l'attribut targetEntity de 
I'annotation ©OneToMany. 
©Entity 

©Table (name = "t_category") 
public class Category 
(...) 

©OneToMany (mappedBy = "category", targetEntity = Product. class) 

private List products; 
(...) 



Definit l'entity avec lequel il faut creer une rela- 
tion. Cet attribut est obligatoire lorsqu'on n'uti- 
lise pas les types generiques. 



Ci-apres le code des deux annotations utilisees pour la cardinalite l:n. 
Code de I'annotation @javax.persistence.OneToMany 
package javax. persi stence ; 

©Target ({METHOD, FIELD}) ©Retention(RUNTIME) 
public ©interface OneToMany { 

Class targetEntityO default void. class; 
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CascadeType[] cascadeQ default {}; 



FetchType fetchQ default FetchType . LAZY; 



} 



Code de I'annotation @javax.persistence.ManyToOne 

package javax. persistence; 

©Target ({METHOD, FIELD}) ©Retention (RUNTIME) 
public ©interface ManyToOne { 

Class targetEntityO default void. class; 
CascadeType[] cascade() default {}; 

FetchType fetch() default FetchType. EAGER; 

boolean optional () default true; 



Operations devant etre propagees a la classe 
associee (decrit dans la suite de ce chapitre). 



Chargement de la relation (decrit par la suite 
dans ce chapitre). 



Utilise lorsqu'on veut creer un lien avec une cle 
etrangere plutot qu'une table de jointure. 



Definit I'entity avec lequel il faut creer une rela- 
tion. Cet attribut est obligatoire lorsqu'on n'uti- 
lise pas les types generiques. 



Operations devant etre propagees a la classe 
associee (decrit dans la suite de ce chapitre). 



Chargement de la relation (decrit par la suite 
dans ce chapitre). 



L'association est-elle facultative ? 



Relation unidirectionnelle l:n 

Les relations unidirectionnelles l:n sont particulieres. En effet, JPA ne 
permet pas l'utilisation des cles etrangeres pour mapper cette relation 
mais uniquement le systeme de table de jointure. Par defaut, le nom de 
cette table intermediate est compose du nom des deux entities separes 
par le caractere Une fois de plus, les annotations JPA permettent de 
redefinir ces valeurs par defaut (en utilisant ©Joi nTabl e). 

Prenons l'exemple d'un bon de commande. Un bon de commande 
(Order) est compose de plusieurs lignes de commande (OrderLine). La 
relation est done multiple et la navigation se fait uniquement dans le 
sens Order vers OrderLine. Ci-apres, le code de I'entity Order avec une 
relation unidirectionnelle l:n vers OrderLine. 

Entity Order avec I'annotation @JoinTable 

©Entity 

©Table(name = "t_order") 
public class Order 
(...) 

©OneToMany 

©Joi nTabl e(name = "t order order line", 

joinCol umns = {©JoinCol umn(name = "order fk")}, 

inverse Joi nColumns = {©Joi nCol umn (name = "order line fk")}) 

private Li st<OrderLi ne> orderLines; 
(...) 

} 



Les donnees de I'entity Order sont rendues 
persistantes dans la table t_order. 



La table de jointure est renommee 
t_order_order_l i ne ainsi que les colon- 
nes des cles etrangeres. 
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Table t_order contenant les donnees du bon ► 
de commande. 



La table des lignes de commande ne possede ► 
pas de cle etrangere vers le bon de commande. 



Cette table cree la jointure entre le bon de com- ► 
mande et ses lignes de commande. La cle pri- 
maire de cette table est constitute des deux cles 
etrangeres. 



Contraintes d'integrite referentielle sur la table ► 
de jointure. 

PERSISTANCE Norn des contraintes d'integrite 

Le nom des contraintes d'integrite est genere 
automatiquement par JPA. Parfois, ce nom peut 
etre assez exotique, comme pour les contraintes 
de la table intermediate entre bons de com- 
mandes qui se nomment 
TRDRORDERLINERDRFK et 
TRDRRDRLINERDRLNFK. 



Nom de la table de jointure. ► 
Catalogue et schema de la table. 1 ► 



Colonne de la cle etrangere faisant reference a ► 
la cle primaire de la table qui maintient la rela- 
tion. 

Colonne de la cle etrangere faisant reference a ► 
la cle primaire de la seconde table. 

Ce tableau permet de definir les contraintes ► 
d'unicite sur une ou plusieurs colonnes. 



Le code precedent indique a JPA de creer une table pour les bons de 
commande et une autre pour faire la jointure avec les lignes de com- 
mandes. Void la DDL que Ton obtient. 

DDL de relation unidirectionnelle avec table de jointure 

CREATE TABLE T ORDER ( 
ID BIGINT NOT NULL, 
PRIMARY KEY (ID) 

) 

CREATE TABLE T ORDER LINE ( 

ID BIGINT NOT NULL, 
PRIMARY KEY (ID) 

) 

CREATE TABLE T ORDER ORDER LINE ( 
ORDER_FK BIGINT NOT NULL, 
ORDER LINE FK BIGINT NOT NULL, 
PRIMARY KEY (ORDER FK, ORDER LINE FK) 

) 

ALTER TABLE T_ORDER ORDER LINE 

ADD CONSTRAINT TRDRORDERLINERDRFK 

FOREIGN KEY (ORDER FK) REFERENCES T ORDER (ID) 

ALTER TABLE T_ORDER ORDER LINE 

ADD CONSTRAINT TRDRRDRLINERDRLNFK 

FOREIGN KEY (ORDER LINE FK) REFERENCES T ORDER LINE (ID) 

Lannotation @Joi nTable est utilisee lorsqu'on veut redefinir les valeurs 
par defaut de la table de jointure. 

Code de I'annotation @javax.persistence.JoinTable 

package javax. persi stence ; 

©Target ({METHOD, FIELD}) ©Retention (RUNTIME) 
! public ©interface Joi nTable { 

String name() default ""; 

String catalog () default ""; 
String schema() default ""; 

JoinColumn[] joinColumnsQ default {}; 



JoinColumn[] inverseJoinColumnsQ default {}; 



UniqueConstraint[] uniqueConstraints() default {}; 

} 
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Relation n:m 



L'etude de cas ne comporte pas de relations n:m mais cet aparte vous 
en explique le fonctionnement. Prenons par exemple un article 
(Item) qui peut avoir plusieurs etiquettes (Label) et vice versa. 



Item 


Label 


Siamois adulte 




Poils courts 






Bulldog male 


-"A 




| \ 


| Persan femelle 


Felin 



Figure 4-3 Relation n:m entre articles (Item) et etiquettes (Label) 

Pour les relations n:m (qu'elles soient unidirectionnelles ou bidirec- 
tionnelles), il faut utiliser I'annotation @ManyToMany dans les deux 
entities. Dans le cas d'une relation bidirectionnelle il faut rajouter 
I'attribut mappedBy. Nous avons done la classe Item qui definit 
une liste de Label annotee avec @ManyToMany. 
©Entity 

public class Item { 
Old 

@GeneratedValue(strategy = Gene rati onType. AUTO) 
private Long id; 



private String name; 
OManyToMany (mappedBy = "item") 

private List<Label> labels; 

} 

Dans le sens inverse, la classe Label utilise elle aussi une annota- 
tion ©ManyToMany sur la liste d'articles. 
©Entity 

public class Label { 
©Id 

@GeneratedValue(strategy = Gene rati onType. AUTO) 
private Long id; 
private String name; 
©ManyToMany 

private List<Item> items; 

} 

Le resultat est que chaque entity persistera ses donnees dans une 
table et la relation n:m sera stockee dans une table de jointure. Par 
defaut, le nom de cette table intermediate est compose des noms 
des deux entities separes par le caractere '_' (I'annotation 
©Joi nTabl e permet de redefinir cette valeur). 

► http://www.devx.com/Java/Article/33650/ 

► http://www.devx.com/Java/Article/33906 



Chargement d'une association 

Toutes les annotations de relations que nous venons de voir (©OneToOne, 
©OneToMany, ©ManyToOne) definissent un attribut agissant sur le chargement 
des relations. L'attribut fetch permet de specifier si vous souhaitez que les 
objets associes se chargent directement (EAGER) ou de maniere differee (LAZY). 

Dans le cas d'un mode de chargement EAGER, les objets lies sont automa- 
tiquement charges. Dans le cas du mode LAZY, les objets sont charges 
uniquement lorsqu'on y accede explicitement. Prenons 1' exemple de la 
categorie, qui est liee a une liste de produits, et un produit lie a sa cate- 
gorie (lien bidirectionnel). Lorsqu'on charge une categorie, on ne veut 
pas que la liste des produits se charge automatiquement. On souhaite 
pouvoir acceder a cette liste seulement lorsque Ton appelle l'accesseur 
category . getProducts(), e'est-a-dire de maniere differee (LAZY). A 
l'inverse, lorsqu'on charge un produit, on veut que sa categorie soit auto- 
matiquement chargee (EAGER). 

Le parametre fetch est tres important car il peut provoquer des problemes 
de performances s'il est mal utilise. Imaginez un modele objet riche et com- 
plexe, oil toutes les relations sont definies automatiquement (EAGER). Cela 
signifierait qua l'appel d'un objet, le systeme aurait a charger automatique- 
ment toute la grappe d'objets lies. Cela aurait des impacts sur la memoire 
du systeme ainsi que sur les performances de la base de donnees. 



Precision Mode fetch par defaut 

Selon le type de relation, l'attribut fetch est par 
defaut soit en mode EAGER soit en mode LAZY : 



Relation 


Fetch par defaut 


©Basic 


EAGER 


©OneToOne 


EAGER 


©ManyToOne 


EAGER 


©OneToMany 


LAZY 


©ManyToMany 


LAZY 
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Une categorie possede une liste de produits 



©Entity 

public class Category 



L'entityCatego ry utilise un chargement differe ► 
pour charger la relation vers ses produits. 



@OneToMany(mappedBy = "category", fetch = FetchType. LAZY) 




Le produit declare le chargement automatique ► 
de sa categorie. 



©ManyToOne (fetch = FetchType. EAGER) 



private Category category; 



(...) 

} 

Ordonner une association multiple 

Les bases de donnees relationnelles ne preservent pas d'ordre dans leur 
table. Ainsi, si on veut recuperer une liste ordonnee de telle ou telle 
maniere, il faut utiliser le mot-cle order by dans les ordres SQL. II en va 
de meme pour les listes d'entities. 

Pour reprendre l'exemple de la categorie et de ses produits, on veut pou- 
voir recuperer cette liste de maniere ordonnee (par ordre ascendant des 
noms de produits). Pour cela, JPA propose l'annotation ©OrderBy que 
Ton peut utiliser sur les annotations ©OneToMany et @ManyToOne. ©OrderBy 
prend en parametre les noms des attributs sur lesquels on souhaite effec- 
tuer un tri, ainsi que le mode (ascendant ou descendant). 

Code de l'annotation @javax.persistence.OrberBy 

package javax. persistence; 

©Target ({METHOD, FIELD}) ©Retention(RUNTIME) 
public ©interface OrderBy { 



Ainsi, pour classer la liste des produits dans l'ordre ascendant du nom, 
on utilise la chaine de caracteres " name ASC " ou " name DESC " pour 
l'ordre descendant. On peut aussi utiliser plusieurs attributs comme 
" name ASC, description DESC " pour trier dans l'ordre croissant des 
noms et decroissant de la description. 



Chaine de caracteres contenant les noms des ► 
attributs de I'entity sur lesquels effectuer le tri. 



String valueQ default 



} 
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Les produits d'une categorie sont classes dans I'ordre ascendant du nom 



©Entity 

public class Category 

@OneToMany(mappedBy = "category", fetch = FetchType . LAZY) 

@OrderBy("name ASC") 

private Li st<Product> products; 
(...) 

} 

©Entity 

public class Product 

private String name; 

©ManyToOne (fetch = FetchType . EAGER) 

private Category category; 

(...) 



Lorsqu'on accede aux produits de la categorie, la 
liste est ordonnee en mode ascendant sur le 
nom des produits (name ASC). 



L'entity produit a un attribut nom (name) sur 
lequel I'ordonnancement se fait. 



Cascade 



Parfois, lorsqu'on effectue une operation sur un entity, on souhaite que 
celle-ci se propage sur les associations. On park alors d'action en cas- 
cade. Par exemple, lorsqu'on supprime une categorie du systeme, on veut 
que ses produits soient egalement supprimes. 

La categorie supprime ses produits en cascade 

©Entity 

public class Category 

@OneToMany(cascade = CascadeType. REMOVE) 

private Li st<Product> products; 
(...) 

} 



L'attribut cascade est present dans les annota- 
tions que nous avons vu precedemment : 
OManyToOne, @0neToMany, et 
OOneToOne 



Heritage 

L'heritage est une notion integree dans les langages objets en general et 
dans Java en particulier. Mais le stockage de cette information hierar- 
chique dans une structure relationnelle nest pas facile a realiser. La 
preuve en est que, jusqu'a l'apparition de JPA, l'heritage n'etait pas pos- 
sible enJ2EE (entity bean 2.x). Grace a JPA, le polymorphisme et l'heri- 
tage sont maintenant possibles. 

Contrairement aux associations qui ont un mapping assez simple (sys- 
teme de cle etrangere ou de table de jointure), l'heritage demande au 
developpeur de choisir entre plusieurs strategies de mapping : 
• SINGLE_TABLE : une seule table par hierarchie de classes (strategic par 
defaut). Cela signifie que les attributs de la classe mere et ceux des 
classes filles sont « aplatis » dans une seule et meme table (figure 4—4). 



Pas d'heritage dans le YAPS Petstore 

L'application YAPS Petstore ne presente pas de cas 
d'heritage. Les notions sur l'heritage JPA sont pre- 
sentees ici sans base d'exemples concrets de 
l'application. 
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Figure 4-4 

Strategie Single Table 



Figure 4-5 

Strategie Table Per Class 



Figure 4-6 

Strategie Joined 




• TABLE_PER_CLASS : une table par classe concrete. Les attributs des 
classes filles, y compris les proprietes heritees, sont mappes dans une 
table. Les attributs de la classe mere sont stockes dans une table a 
part pour effectuer les jointures. Notez que cette strategie est faculta- 
tive dans la specification JPA 1.0 (figure 4-5). 




• JOINED : une table par classe. Dans cette strategie, la classe mere ainsi 
que les classes filles sont mappees dans une table. Les attributs 
herites de la table mere ne se retrouvent pas dans les tables filles 
(figure 4-6). 



Le choix de la strategie s'effectue dans la classe mere en utilisant l'anno- 
tation @javax. persistence. Inheritance conjointement au type d'heri- 
tage (SINCLE_TABLE, TABLE_PER_CLASS OU JOINED). 

Classe mere 

©Entity 

@Inheritance(strategy = InheritanceType. JOINED) 

public class Address { 

Old 

private Long id; 
private String streetl; 
// (...) 

} 

Classe fille 

©Entity 

public class CompanyAddress extends Address { 



private String postmail; 
// C.) 

} 



Le cycle de vie d'un entity 

Comme nous l'avons deja dit, avec l'arrivee de JPA, un entity est mainte- 
nant une simple classe Java. Un simple appel au mot-cle new permet 
d'instancier un entity et de le manipuler comme toute autre classe. La 
seule difference notoire est l'utilisation des annotations que nous venons 
de voir permettant a JPA de prendre en compte cette classe et de la 
rendre persistante. On dit alors que la classe est « managee » par JPA. Le 
traitement inverse, lorsque la classe cesse d'etre « managee », est appele 
« detache ». 

Pour illustrer ces principes, prenons une classe persistante, Category par 
exemple. Lorsque cette classe veut acceder a la base de donnees, elle a 
besoin d'etre managee. Par contre, lorsqu'elle doit traverser plusieurs 
couches de 1' application pour etre affichee sur la partie cliente, elle se 
detache et ne peut plus alors manipuler les donnees. Un entity cesse 
automatiquement d'etre « manage » lorsqu'il se serialise. 

Le diagramme d'etat suivant decrit les differents etats que peut prendre 
un entity. II doit etre lu comme suit. Lorsqu'on instancie un entity, cet 
objet existe en memoire uniquement. Ce n'est que lorsque JPA le prend 
en compte qu'il devient manage. Si on met a jour l'entity, ou que Ton 
parcourt ses relations vers d'autres objets, il reste manage. II se detache 
lorsqu'il se « deplace » vers une autre couche, par exemple, et peut etre 
rattache (done manage) a son retour. Lorsqu'on supprime un entity, il 
supprime ses donnees de la base avant de disparaitre de la memoire de la 
JVM. 

Notez la presence de declencheurs sur chaque transition (@PrePersist, 
OPreRemove, etc.). Ces points d'attache, ou methodes de callback, sont 
appeles par JPA lorsque l'entity change d'etat. 



s I 'objet 



Prise en compte par JPA : @PrePersist, @PostPersist 



Serialise vers une couche exterieure 



' Detache \^ 




Suppressi >n : @P re Remove 



Retour d'une couche externe 
Reprise en compte par JPA 



IF 



ilL Diagramme d'etats 



Ce diagramme sert a representer des automates 
d'etats finis, sous forme de graphes d'etats, relies 
par des arcs orientes qui decrivent les transitions. 
Les diagrammes d'etats permettent de decrire les 
changements d'etats d'un objet ou d'un compo- 
sant, en reponse aux interactions avec d'autres 
objets ou avec des acteurs. 



Recherche d'un objet e*istant : @Postl_oacl 



s a jour : ©PreUpdate, ©PostUpdate 



Figure 4-7 

Cycle de vie d'un entity 
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Syntaxe Les methodes callback 

Une methode callback possede les caracteristiques 
suivantes : 

• elle peut etre annotee par une ou plusieurs 
annotations callback ; 

• elle ne peut lancer que des 
RuntimeException ; 

• elle peut etre public, package, 
protected ou private. 



Remarque Exceptions 



Lorsque la valeur d'un attribut est invalide, les 
entities levent une Val i dati on Excepti on. 
Cette exception applicative sera vue en detail dans 
le prochain chapitre, Traitements metier. 



L'entity Category a un attribut nom et des- 
cription. 



Avant d'effectuer une insertion ou une mise a 
jour des donnees en base, JPA appelle la 
methode val i dateData. Cette methode 
s'assure que les attributs nom et description 
sontvalides. 



Les annotations de callback 

Grace aux annotations de callback, JPA laisse la possibilite aux deve- 
loppeurs de raj outer des traitements avant ou apres qu'un changement 
d'etat se produise. II existe sept annotations qui correspondent a ces dif- 
ferents points d'attache. 

• @javax. persistence. PrePersist 

• @javax. persi stence . PostPersi st 

• @javax. persi stence . PreRemove 

• @javax. persi stence . PostRemove 

• @javax. persistence. PreUpdate 

• @javax . persi stence . PostUpdate 

• @javax. persistence. PostLoad 

Avant d'inserer un entity en base, JPA execute les methodes annotees 
par ©PrePersist. Si l'insertion ne rencontre pas de problemes ou 
d'exceptions, les methodes annotees ©PostPersi st sont executees. II en 
est de meme pour les mises a jour (@PreUpdate, ©PostUpdate) et les sup- 
pressions (@PreRemove, ©PostRemove). Par contre, 1' annotation ©PostLoad 
est appelee lorsqu'un entity est charge a partir de la base de donnees via 
une requete ou une association. 

Dans l'exemple suivant, l'entity Category valide ses donnees avant son 
insertion en base (©PrePersist) ou sa mise a jour (©PreUpdate). Si les 
donnees ne sont pas valides, une exception est lancee. 

Categorie utilisant des annotations de callback 

©Entity 

public class Category 
©Id 

©CeneratedVal ue 
private Long id; 

private String name; 
private String description; 
(...) 

©PrePersist 
©PreUpdate 

private void val i dateDataO { 

if (name == null || "". equal s(name)) 

throw new ValidationException("Invalid name"); 
if (description == null || "". equal s(descri ption)) 

throw new ValidationException("Invalid description"); 

} 
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Les entities de YAPS Pet Store 



Apres avoir decouvert le fonctionnement de JPA et de certaines annota- 
tions, il ne nous reste plus qua etudier son application sur les objets per- 
sistants de YAPS Pet Store. 

Pour cela, il nous faut definir les objets persistants de l'application a 
partir des cas d'utilisation du premier chapitre. Un moyen simple con- 
siste a trouver les noms (et pas les verbes) qui reviennent frequemment 
dans les cas d'utilisation. Les objets a rendre persistants representent 
souvent des choses, comme un article ou un bon de commande. lis 
encapsulent leurs donnees (on park d'attributs) et leur comportement 
(les methodes). 

Charge a l'analyste qui sommeille en nous de trouver les objets persis- 
tants. Ainsi, il n'y aura pas d'objet catalogue (la societe YAPS n'a qu'un 
seul catalogue) mais plutot des categories (Category), des produits 
(Product) et des articles (item). On retrouvera aussi des clients 
(Customer) et des adresses (Address). Lorsque les achats sont effectues, 
on obtient un bon de commande (Order), constitue de lignes de com- 
mande (OrderLine) et payable par carte bancaire (CreditCard). 

Retour d'experience Anglais ou francais ? 

L'informatique, et plus precisement le langage Java, est dominee par la 
langue anglaise. A tel point que certaines specifications nous imposent 
des termes anglo-saxons (par exemple, les Java beans doivent avoir des 
accesseurs qui commencent par les mots get et set, ou une methode 
toString). Ces regies nous imposant I'anglais, il nous faut ensuite 
melanger le francais pour obtenir un franglais que je trouve plus diffi- 
cile a lire (ex. getNom, setPrenom alors que getName ou setAddress sont 
plus clairs et compris de tous). La plupart des developpeurs sont mainte- 
nant habitues a utiliser des termes anglais pour les classes, methodes et 
attributs. II est sage de I'imposer comme regie de developpement dans 
une equipe pour eviter le franglais ou le melange des deux langues dans 
le code source. Ce livre utilisera done uniquement des termes anglais 
pour les classes, attributs et methodes. Par contre, les commentaires 
seront en francais. 



Le catalogue 

La societe YAPS possede un catalogue d'animaux domestiques. Ce cata- 
logue est structure en categories, en produits puis en articles. Ce sont ces 
articles que les clients peuvent acheter. Ci-apres le diagramme de classes 
representant ce decoupage (figure 4-8). 



UML Les mots dans les cas d'utilisation 

Cette methode simple, consistant a trouver les 
noms qui reviennent frequemment dans les cas 
d'utilisation, est tellement repandue que certains 
outils I'utilisent. Visual Paradigm, par exemple, 
possede un systeme d'analyse textuelle (Textual 
Analysis) qui, a partir du texte, realise des dia- 
grammes de classes approximatifs. 
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UML Diagramme de classes 

Un diagramme de classes est une collection d'ele- 
ments de moderation statiques (classes, inter- 
faces, paquetages, etc.), qui montrent la structure 
d'un modele. II fait abstraction des aspects dyna- 
miques et temporels. Ce diagramme se concentre 
sur les relations entre classes (association, heri- 
tage, etc.), leurs attributs et methodes. 



On doit lire le diagramme de la maniere suivante. Une categorie 
(Category) peut avoir zero ou plusieurs produits (Product), et un produit 
peut avoir zero ou plusieurs articles (item). On notera l'utilisation de 
liens de composition bidirectionnels entre ces classes. La composition (le 
losange noir a 1' extremite de la classe) nous indique qu'il y a une relation 
forte entre ces objets. Ainsi, la suppression d'une categorie entrainera la 
suppression de ses produits et des articles lies a ce produit (JPA utilise la 
notion de cascade). 

En ce qui concerne les attributs de ces trois classes, ils suivent 1' expres- 
sion des besoins decrite dans le premier chapitre. La categorie et le pro- 
duit comportent un identifiant (id), un nom (name) et une description 
(description). Larticle possede un prixunitaire (unitCost) etune image 
representant 1' animal a vendre (imagePath). 



Persistance Les images 



Pour pouvoir afficher une image pour chaque 
animal, il est necessaire que cette image soit 
stockee dans le systeme. Deux possibility s'offrent 
a nous. Soit I'image est stockee directement en base 
de donnees sous forme de BLOB (Binary Large 
Object), soit le nom du repertoire physique ou se 
trouve I'image est stocke en base de donnee. Cette 
derniere solution est plus simple a mettre en oeuvre. 
L'attribut imagePath de la classe Item contient 
done le chemin d'acces a I'image (par exemple : 
/i mages/poi ssonRouge . gi f). 



Les relations dans un diagramme de classes UML 

Dans un diagramme de classes, il existe quatre types de relations : 

• Heritage : mecanisme par lequel des elements plus specifiques incor- 
porent la structure et le comportement d'elements plus generaux. En 
UML, on represente un heritage par une ligne avec un triangle a son 
extremite. 

• Association : relation semantique entre deux ou plusieurs classes. 
C'est une connexion, bidirectionnelle par defaut, entre leurs ins- 
tances. Representee par une ligne. 

• Agregation : une forme speciale d'association qui specifie une rela- 
tion « tout-partie » entre I'agregat (le tout) et une partie. Repre- 
sentee par une ligne avec un losange vide a une extremite. 

• Composition : une forme d'agregation qui exprime une forte pro- 
priete entre le tout et les parties, ainsi qu'une subordination entre 
I'existence des parties et du tout. Les parties vivent et meurent avec le 
tout (elles partagent sa duree de vie). La composition est representee 



Categorie 

La societe YAPS vend cinq categories d'animaux domestiques : chats, 
chiens, reptiles, poissons, oiseaux. Chaque categorie contient une liste de 
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produits O triee par nom ©, a laquelle on accede de maniere differee ©. 
L'utilisation des annotations de callback permet a l'entity de verifier la 
validite de ses attributs avant l'insertion et la mise a jour en base de don- 
nees ©. 

Code de l'entity Category 

package com . yaps . petstore . enti ty . catal og ; 

©Entity 

@Table(name = "t_category") 

public class Category implements Se realizable { 
©Id 

@GeneratedVal ue (strategy = Gene rati onType .AUTO) 
private Long id; 

@Column (null able = false, length = 30) 
private String name; 
©Column (null able = false) 
private String description; 

@OneToMany(mappedBy = "category", 

cascade = CascadeType . REMOVE , 

fetch = FetchType.LAZY) © 
@0rderBy("name ASC") © 
private List<Product> products; © 

@PrePersi st 
@PreUpdate 

private void val idateData() {© 

if (name == null || "" .equals(name)) 

throw new ValidationException("Invalid name"); 

if (description == null || "". equal s(descri ption)) 
throw new ValidationException("Invalid description"); 

} 

// constructeurs , accesseurs 

// methodes hashcode, equals et toString 

} 

Produit 

Chaque categorie d'animaux domestiques est subdivisee en produits. Ainsi, 
la categorie chats contiendra les produits Siamois, Persan, Chartreux, etc. 
L'entity Product possede un lien bidirectionnel avec la categorie, il a done 
un attribut qui lui fait reference Q. Un produit contient une liste d'articles 
©, triee par nom ©, et accedee de maniere differee ©. 

Code de l'entity Product 

package com . yaps . petstore . enti ty . catal og ; 

©Entity 



< Entity Catego ry rendant persistantes ses don- 
nees dans la table t_category. 

< Une categorie a un identifiant unique, un nom et 
une description. 



< Une categorie possede une liste de produits 
accessible de maniere differee. La suppression 
d'une categorie entraine la suppression en cas- 
cade de tous ses produits. La liste est triee par 
nom de produits. 

< Avant d'inserer ou de mettre a jour les donnees 
en base, cette methode est appelee par JPA. Elle 
permet de valider les attributs de l'entity et ren- 
voie une exception en cas d'incoherence. 



Remarque Implementer Serializable 

Notez que l'entity Category implemente Inter- 
face Serializable. Comme nous I'avons vu 
dans notre architecture, les entities vont etre uti- 
lises par les applications clientes (Swing et JSP), lis 
vont done etre transports a travers le reseau. Java 
utilise I'interface Serializable ou 
Exte rnal i zabl e pour pouvoir transporter des 
objets a travers le reseau. On appelle cela la seria- 
lisation des donnees. La plupart de nos entities 
seront utilises par des applications distantes, ils 
implementeront done I'interface 

Serializable. 
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Entity Product rendant persistantes ses don- 
nees dans la table t_product. 



Un produit a un identifiant unique, un nom et 
une description. 



Le produit a connaissance de sa categorie. Cette 
association est chargee automatiquement. 

Un produit possede une liste d'articles accessible 
de maniere differee. La suppression d'un produit 
entrame la suppression en cascade de tous ses 
articles. La liste est triee par nom d'articles. 



Avant d'inserer ou de mettre a jour les donnees I ► 
en base, cette methode est appelee par JPA. Elle | 
permet de valider les attributs de I'entity et ren- 
voie une exception en cas d'incoherence. 



©Tabl e(name = "t_product") 

public class Product implements Serializable { 



Gene rati onType. AUTO) 



Old 

©GeneratedVal ue(strategy 
private Long id; 

©Column (null able = false, length = 30) 
private String name; 
©Column (null able = false) 
private String description; 

©ManyToOne (fetch = FetchType. EAGER) 
@JoinColumn(name = "category^f k" , null able = false) 
private Category category; Q 

@OneToMany(mappedBy = "product", 

cascade = CascadeType . REMOVE, 

fetch = FetchType. LAZY) Q 
@0rderBy("name ASC") © 
private List<Item> items; Q 

©PrePersi st 
©PreUpdate 

private void val idateDataO { 

if (name == null || "". equal s(name)) 

throw new ValidationException("Invalid name"); 
if (description == null || "". equal s(descri ption)) 

throw new ValidationException("Invalid description"); 

} 

// constructeurs , accesseurs 

// methodes hashcode, equals et toString 



Article 



Entity Item rendant persistantes ses donnees 
dans la table t_i tern. 



Un article a un identifiant unique, un nom, un 
prix unitaire et une image representant I'animal 
domestique. 



Chaque produit est subdivise en articles. Le produit chat Siamois com- 
porte done les articles suivants : adulte male et adulte femelle. L'article 
est 1' element qu'il est possible d'acheter dans le catalogue de la societe 
YAPS. Un client peut done rajouter ces articles dans son panier et les 
acheter. Un article a un prix unitaire et possede un lien bidirectionnel 
avec son produit Q. 

Code de I'entity Item 

package com . yaps . petstore . enti ty . catal og ; 

©Entity 

@Table(name = "t_item") 

public class Item implements Serializable { 



©Id 

©GeneratedVal ue(strategy 
private Long id; 

©Column (null able = false, length 
private String name; 



Generati onType .AUTO) 
30) 
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@Column(name = "uni t_cost" , nullable = false) 
private Float unitCost; 
©Column (name = "image_path") 
private String imagePath; 

@ManyToOne (fetch = FetchType . EAGER) 

@Joi nCol umn(name = "product_f k" , null able = false) 

private Product product; Q 

@PrePersi st 
@PreUpdate 

private void val idateDataO { 

if (name == null || "" .equals(name)) 

throw new ValidationException("Invalid name") ; 

} 

// constructeurs , accesseurs 

// methodes hashcode, equals et toString 



L'article a connaissance de son produit. Cette 
association est chargee automatiquement. 



Avant d'inserer ou de mettre a jour les donnees 
en base, cette methode est appelee. Elle permet 
de valider les attributs de I'entity et renvoie une 
exception en cas d'incoherence. 



Le client 

Les cas d'utilisation nous ont donne plusieurs informations sur la gestion 
des clients, ce qui nous permet d'extraire le diagramme de classes suivant 
(figure 4-9). 



«entity>> 
Customer 

id : Long 
■login : String 
■passvwrd : String 
■tirstname : String 
■lastname : String 
telephone : String 
email : String 
dateOeirth : Date 
■ /age : Integer 



. H 


«entity» 


ome Address 


Address 


-id : Long 
-street 1 : String 
-street2 : String 
-city: String 
-state : String 
-opcode : String 
-country : String 



Figure 4-9 

Diagramme de classes du client 



Un client possede un identifiant (id) et un login unique. Grace a ce 
login et a son mot de passe (password), il peut se connecter au systeme. 
Ses coordonnees sont constituees d'un nom (lastname), prenom 
(firstname), numero de telephone (telephone), adresse e-mail (email), 
date de naissance (dateOf Bi rth) et une adresse personnelle (optionnelle 
d'ou la cardinality 0:1). Cette adresse est decrite par la classe Address et 
comporte les attributs rue (Streetl, Street2), ville (city), etat (state), 
code postal (zipcode) et pays de residence (country). 



UML Attribut derive 



Remarquez le caractere « / » devant I'attribut age. 
En UML, il signifie que I'element (attribut ou 
methode) est derive, c'est-a-dire qu'il est calcule a 
partir d'autres attributs. Dans le cas du client, I'age 
est calcule a partir de sa date de naissance. 
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Entity Customer rendant persistantes ses don- 
nees dans la table t customer. 



Un client possede un identifiant unique, un nom, 
un prenom, un numero de telephone et une 
adresse e-mail. Le login et le mot de passe sont 
utilises pour se connecter au systeme. 



A partir de la date de naissance, on calcule I'age 
du client (dans la methode cal cul ateAge). 
Cet attribut n'est pas stocke en base de donnees 
(transient). 



Association unidirectionnelle vers I'adresse, 
chargee automatiquement. 



Avant d'inserer ou de mettre a jour les donnees 
en base, cette methode est appelee. Elle permet 
de valider les attributs de I'entity et renvoie une 
exception en cas d'incoherence. 



Client 

L'entity Customer (client) est une classe riche en informations. Outre ses 
attributs, cet entity utilise plusieurs annotations de callback pour valider 
ses donnees O m ais aussi pour calculer l'age du client ©. II utilise une 
methode metier © pour verifier que le mot de passe, saisi par le client lors 
de la connexion, est bien le meme que celui stocke en base de donnees. 
Cette methode metier est appelable par des composants externes (la 
methode est publique) et n'utilise pas d'annotations de callback. Un client 
possede un lien unidirectionnel avec 1'entity Address ©. 

Code de l'entity Customer 

package com . yaps . petstore . enti ty. customer ; 
©Entity 

@Table(name = "t_customer") 

public class Customer implements Serial izable { 



Old 



Cenerati onType . AUTO) 

false, length = 8) 
8) 
30) 
30) 



1 ength 
1 ength 
1 ength 



@GeneratedVal ue(strategy 
private Long id; 
©Column (unique = true, nullable 
private String login; 
©Column (null able = false, 
private String password; 
©Column (null able = false, 
private String firstname; 
©Column (null able = false, 
private String lastname; 
private String telephone; 
private String email; 

©Column(name = "date_of_bi rth") 
©Temporal (Tempo ral Type . DATE) 
private Date dateOfBirth; 
©Transient 
private Integer age; 

©OneToOne (fetch = FetchType. EAGER, 
@JoinColumn(name = "address^f k" , 
private Address homeAddress ; © 

©PrePersi st 
©PreUpdate 

private void val idateDataO { 0 

if (firstname == null || "". equal s(fi rstname)) 

throw new ValidationException("Invalid first name"); 
if (lastname == null || "". equal s(l astname)) 

throw new ValidationException("Invalid last name"); 
if (login == null || "". equal s(logi n)) 

throw new ValidationException("Invalid login"); 
if (password == null || "". equal s(password)) 

throw new Val idationExcepti on ("Invalid password"); 

} 



cascade = CascadeType.ALL) 
nullable = true) 
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@Postl_oad 
@PostPersist 
©PostUpdat 

public void calculateAgeO { Q 

if (dateOf Birth == null) { 
age = null ; 
return ; 

} 

Calendar birth = new GregorianCalendarO ; 
bi rth . setTi me (dateOf Bi rth) ; 
Calendar now = new GregorianCalendarO; 
now. setTime(new DateO); 
int adjust = 0; 

i f (now . get (Cal endar . DAY_OF_YEAR) 

- birth, get (Cal endar. DA Y_0F_YEAR) < 0) { 
adjust = -1; 

} 

age=now. get (Cal endar . YEAR) -bi rth . get (Cal endar . YEAR)+ad j ust ; 

} 

public void matchPassword(String pwd) { Q < 

if (pwd == null || "".equals(pwd)) 

throw new ValidationException("Invalid password"); 
if (! pwd. equals (password)) 

throw new Val idationException("Passwords don't match"); 

} 

// constructeurs , accesseurs 

// methodes hashcode, equals et toString 



Adresse 

L'entity Address est utilise pour representer l'adresse de domiciliation du 
client et l'adresse de livraison de la commande. 

Code de l'entity Address 

package com . yaps . petstore . enti ty ; 

©Entity 

@Table(name = "t_address") 

public class Address implements Serial izable { 
Old 

@GeneratedValue (strategy = Gene rati onType. AUTO) 
private Long id; 
©Column (null able = false) 
private String streetl; 
private String street2; 
©Column (null able = false, length = 100) 
private String city; 
private String state; 

©Column (name = "zip_code", null able = false, length = 10) 
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< Lorsque l'entity est charge (©PostLoad), ou 
apres que ses donnees aient ete inserees ou 
mises a jour, on calcule I'age du client a partir de 
sa date de naissance. 



Cette methode metier verifie que le mot de 
passe passe en parametre est valide, et qu'il est 
identique a celui stocke dans la base de don- 
nees. 



< Entity Address rendant persistantes ses don- 
nees dans la table t_address. 

< Une adresse est composee d'un identifiant uni- 
que, de deux attributs pour stacker la rue, d'une 
ville, d'un etat, d'un code postal et d'un pays. 



Avant d'inserer ou de mettre a jour les donnees 
en base, cette methode est appelee. Elle permet 
de valider les attributs de I'entity et renvoie une 
exception en cas d'incoherence. 



private String zipcode; 

©Column (null able = false, length = 50) 

private String country; 

@PrePersi st 
@PreUpdate 

private void val idateDataO { 

if (streetl == null || "". equal s(streetl)) 

throw new ValidationException("Invalid street"); 
if (city == null || "". equal s(city)) 

throw new ValidationException("Invalid city"); 
if (zipcode == null || "". equal s(zi pcode)) 

throw new ValidationException("Invalid zip code"); 
if (country == null || "". equal s(country)) 

throw new ValidationException("Invalid country"); 

} 

// constructeurs , accesseurs 

// methodes hashcode, equals et toString 



UML Stereotypes 



En UML, les stereotypes permettent de creer de 
nouveaux elements de moderation, lis sont 
represented soit par un graphique (comme I'acteur 
dans les cas d'utilisation), soit entre guillemets. 
Dans nos diagrammes de classes, les entities sont 
stereotypes «enti ty». 



Le bon de commande 

Lorsque le client achete des animaux de compagnie, un bon de com- 
mande est automatiquement cree par le systeme. Un bon de commande 
(Order) est constitue de lignes de commandes (OrderLine). II fait refe- 
rence au client (Customer)qui a passe la commande. II est payable par 
une carte bancaire (CreditCard). 



Figure 4-10 

Diagramme de classes du bon de commande 




Le diagramme de classes precedent nous montre les attributs du bon de 
commande (identifiant et date de creation), des lignes de commandes 
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(quantite achetee et reference vers l'article achete) et la carte de credit 
(numero de la carte, date de fin de validite et type). 

Notez que ces entities ont des liens avec des paquetages externes 
(comme l'article qui se trouve dans le paquetage catalog par exemple). 
La classe Address, quant a elle, se trouve a la racine du paquetage 
com. yaps. petsto re. entity puisqu'elle est commune au bon de com- 
mande et au client. 



Bon de commande 



Le bon de commande est relie a differents entities : au client Q qui a passe 
la commande, a l'adresse de livraison © et a ses lignes de commandes 0 
(lien unidirectionnel). Quant a la carte de credit, elle est englobee grace a 
l'utilisation de 1' annotation ©Embedded 0. Lors de l'insertion du bon de 
commande en base, on affecte la date de creation a la date courante grace a 
une methode annotee par ©PrePersist 0. La methode metier getTotal 
0 calcule le montant total du bon de commande, c'est-a-dire quelle 
cumule le montant de chaque ligne de commande. 

Code de I'entity Order 

package com . yaps . petsto re . enti ty . orde r ; 

©Entity 

@Table(name = "t_order") 

public class Order implements Serial izable { 
@Id 

@GeneratedVal ue (strategy = Gene rati onType .AUTO) 
private Long id; 

@Column(name = "order_date" , updatable = false) 
©Temporal (Tempo ral Type . DATE) 
private Date orderDate; 

@ManyToOne (fetch = FetchType . EAGER) 

@Joi nCol umn(name = "customer_f k" , null able = false) 

private Customer customer; 0 

@0neTo0ne (fetch = FetchType . EAGER, cascade = 
CascadeType . ALL) 

@Joi nCol umn(name = "address_f k" , null able = false) 
private Address deliveryAddress; 0 

©Embedded 

private CreditCard creditCard = new CreditCard() ; 0 

@OneToMany(cascade = CascadeType .ALL , 
fetch = FetchType. EAGER) 

@JoinTable(name = "t_order_order_l i ne" , 

joinColumns = {@Joi nCol umn(name = "order_f k")} , 

i nverseJoi nCol umns={@Joi nCol umn (name="order_l i ne_f k") }) 

private List<OrderLine> orderLines; 0 



Entity Order rendant persistantes ses donnees 
dans la table t_order. 



Le bon de commande possede un identifiant uni- 
que et une date de creation. 



Lien unidirectionnel avec le client. 



Lien unidirectionnel avec l'adresse de livraison. 



Les donnees de la carte de credit sont englobees 
dans la meme table que le bon de commande. 



Le lien unidirectionnel avec les lignes de com- 
mandes est effectue a I'aide de la table de join- 
ture t_order_order_l i ne. On redefinit les 
colonnes de des etrangeres grace aux annota- 
tions @Joi nCol umn. 
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Lors de I'insertion en base, la date de creation du 
bon de commande est initialisee avec la date 
courante. 



Cette methode metier calcule le montant total 
du bon de commande. Pour cela, elle itere la liste 
des lignes de commandes et cumule les sous- 
totaux (en appelant la methode 
getSubTotal). 



} 



@PrePersi st 

private void setDefaul tData() { 0 

order-Date = new DateO; 

} 

public Float getTotal () { 0 

if (orderLines == null || orderLi nes . i sEmptyO) 
return Of; 

Float total = Of; 

for (OrderLine orderLine : orderLines) { 
total += (orderLi ne. getSubTotal ()) ; 

} 

return total ; 

} 

// constructeurs , accesseurs 

// methodes hashcode, equals et toString 



Entity OrderLine rendant persistant ses don- 
nees dans la table t_order_l i ne. 



Une ligne a un identifiant unique et la quantite 
d'articles achetes par le client est indiquee. 



L'article reference par la ligne de commande est 
charge de maniere automatique. 



Avant d'inserer ou de mettre a jour les donnees 
en base, cette methode est appelee. Elle permet 
de valider les attributs de I'entity et renvoie une 
exception en cas d'incoherence. 



Methode metier calculant le sous-total d'une 
ligne de commande, c'est-a-dire le prix de l'arti- 
cle multiplie par la quantite achetee. 



Ligne de commande 

Un bon de commande est constitue d'une ou plusieurs lignes de com- 
mande. Chacune d'elles nous informe de la quantite d'articles achetes. 
Ainsi, une ligne de commande fait reference a un article Q par un lien 
unidirectionnel. 

Code de I'entity OrderLine 

package com . yaps . petstore . enti ty. order ; 

©Entity 

@Table(name = "t_order_l i ne") 

public class OrderLine implements Serializable { 
@Id 

@GeneratedVal ue(strategy = CenerationType . AUTO) 

private Long id; 

©Column (null able = false) 

private Integer quantity; 

OOneToOne (fetch = FetchType . EAGER) 
@JoinColumn(name = "iterrufk", null able = false) 
private Item item; 0 

@PrePersi st 
OPreUpdate 

private void val idateDataO { 

if (quantity == null | | quantity < 0) 

throw new ValidationException("Invalid quantity"); 

} 

public Float getSubTotal () { 

return item.getUnitCost() * quantity; 

} 



102 



// constructeurs , accesseurs 

// methodes hashcode, equals et toString 

} 



Carte de credit 



L'entity Credi tCard utilise 1' annotation ©Embeddabl e Q pour pouvoir etre 
englobe par le bon de commande. 

Code de l'entity CreditCard 

package com. yaps . petstore. entity .order; 

@Embeddable Q 

public class CreditCard implements Serializable { 

@Column(name = "credit_card_number" , length = 30) 
private String credi tCardNumber ; 
©Column (name = "credi t_card_type") 
private String credi tCardType; 

@Column(name = "credi t_card_expi ry_date" , length = 5) 
private String credi tCardExpDate; 

©PrePersi st 
@PreUpdate 

private void val idateDataO { 

if (credi tCardNumber==nul 1 || "" .equals(creditCardNumber)) 
throw new ValidationException("Invalid number"); 

if (credi tCardType == null || "" .equals(creditCardType)) 
throw new ValidationException("Invalid type"); 

if (credi tCardExpDate==null | | "".equals(creditCardExpDate)) 
throw new ValidationException("Invalid expiry date"); 

} 

// constructeurs, accesseurs 

// methodes hashcode, equals et toString 



Paquetages des entities 

Les classes de 1' application YAPS Pet Store sont developpees dans le 
paquetage com. yaps. petstore. La regie de nommage est la suivante : les 
paquetages des applications commerciales commencent par com, suivi du 
nom de l'entreprise (yaps) et du nom du projet (petstore). Les objets 
persistants que nous venons de voir se trouvent tous dans le paquetage 
com . yaps . petstore . enti ty. 



Les donnees de la carte de credit sont englobees 
par l'entity Order. Les donnees sont done stoc- 
kees dans la table t_order. 



La carte de credit n'est pas un entity, elle n'a 
done pas d'identifiant unique. Elle est constitute 
d'un numero, d'un type (Visa, Master Card, etc.) 
et d'une date d'expiration au format mois/annee 
(MM/AA). 



Avant d'inserer ou de mettre a jour les donnees 
en base, cette methode est appelee. Elle permet 
de valider les attributs de l'entity et renvoie une 
exception en cas d'incoherence. 



-- i. com 

h- yaps 

B- petstore 
^- E£ entity 
^- catalog 

- C; ft Category 
c Item 
c ' ft Product 
I 3- S/ customer 

I- ft Customer 
^- E£ order 

c "£a Oedit'Iard 
C Ta Order 
(5>ft OrderLine 
(g)ft Address 

Figure 4-1 1 Paquetages et entities 
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Schema de la base de donnees 



Tous les entities de l'application YAPS Pet Store que nous venons de 
voir sont rendus persistants dans des tables. Leurs attributs et leurs rela- 
tions nous donnent le schema de base de donnees suivant : 
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IMAGE.PATH 
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Figure 4-12 Schema de la base de donnees 



Notez la presence de la table de jointure t_order_order_1 i ne qui permet 
de stocker les cles etrangeres du bon de commande et de ses lignes. 



En resume 

Dans ce chapitre, nous avons developpe les objets persistants de l'appli- 
cation YAPS Pet Store. Pour cela, nous avons utilise JPA qui permet de 
simplifier le mecanisme de mapping objet-relationnel. Cette specifica- 
tion presente l'avantage d'avoir reconcilie les detracteurs des entity beans 
2.x avec Java EE sans decevoir les utilisateurs de frameworks Open 
Source dont elle s'est inspiree. Dans le chapitre suivant, nous decouvri- 
rons comment manipuler ces objets a partir d'une couche de traitements 
de stateless session beans. 



chapitre 





Traitements metier 



Dans le chapitre precedent, nous avons implements les objets 
persistants de l'application sous forme d'entities. Nous allons 
maintenant developper la couche de traitements qui les manipulera, 
en utilisant les EJB session sans etat (stateless). Cette couche 
se charge de gerer les exceptions, de demarquer les transactions, 
et utilise l'entity manager de JPA ainsi que son langage de requetes 
JPQL pour acceder aux donnees. 



SOMMAIRE 

► Couche de traitements metier 

► Gestion du catalogue 
et des clients 

► Stateless session bean 

► Cycle de vie des stateless beans 

► Interfaces locale et distante 

► Entity manager 

► Langage de requetes JPQL 

► Gestion des exceptions 

► Demarcation des transactions 

MOTS-CLES 

► Stateless bean 

► Entity manager 

► JPQL 

► Contexte de persistance 

► CRUD 

► Logging 



Architecture Separation des responsabilites 

La separation des responsabilites, ou Separation 
of Concerns, est le processus visant a decouper 
un programme en elements distincts dont les fonc- 
tionnalites se recouvrent le moins possible. Dans 
notre cas, les entities s'occupent de la persistance, 
les stateless des traitements et I'interface gra- 
phique de I'affichage. Ceci garantit le principe de 
separation des donnees, des traitements et des 
interfaces pour faciliter la maintenance et la reuti- 
lisabilite de tout ou partie d'un logiciel. 



Rappel CRUD 

Operations de base pour la persistance. Le terme 
CRUD signifie en anglais : Create, Retrieve (ou 
Read), Update, Delete, c'est-a-dire la creation, la 
lecture, la mise a jour et la suppression de donnees. 




Figure 5-1 

Plusieurs clients pour un meme stateless bean 



Les entities etudies au chapitre precedent offrent un modele de persis- 
tance objet. lis encapsulent les donnees et leur mapping relationnel grace 
aux annotations JPA, tout comme ils decrivent des methodes metier qui 
leur sont propres. En revanche, les entities ne sont pas faits pour repre- 
senter les taches complexes qui necessiteraient une interaction avec 
d'autres objets persistants. Ce n'est pas la couche appropriee pour ce type 
de traitements. De la meme maniere, I'interface utilisateur ne doit pas 
comporter de logique metier (surtout lorsqu'on multiplie le nombre 
d'interfaces, Web et Swing, ce qui nous pousserait a dupliquer du code). 
Pour decorreler les objets persistants de la couche de presentation, nous 
utilisons une couche de traitements metier, implementee sous forme de 
stateless beans. 

Cette couche de traitements va agir comme un chef d'orchestre. Elle 
effectue des operations de persistance sur les entities (CRUD), enchaine 
les appels aux entities et rajoute de la logique metier. 



Stateless session bean 

Un stateless session bean, ou composant sans etat, est un objet parti oi- 
lier qui reside dans un conteneur (on parle alors de conteneur d'EJB). 
Contrairement aux entities, les EJB stateless ne persistent pas de don- 
nees, ils servent a executer des traitements. Comme son nom l'indique, 
le stateless session bean ne possede pas d'etat. En effet, il sert a l'execu- 
tion d'un traitement et retourne un resultat sans avoir connaissance des 
appels precedents ou futurs. Par exemple, une application cliente con- 
tacts un stateless bean et lui transmet des parametres. Le stateless bean 
selectionne des entities correspondant aux parametres, et retransmet un 
resultat au client. Lorsque ce traitement s'acheve, le stateless bean ne 
conserve aucun souvenir de cette interaction. 

Parce qu'il ne possede pas d'etat, un stateless bean peut etre utilise par 
differents clients. Ainsi, le meme EJB pourra retourner un resultat a un 
client puis, immediatement apres, executer le meme traitement pour un 
autre client. Ceci implique qu'un appel de methode doit passer tous les 
parametres necessaires a sa bonne execution. II est done impossible 
d'appeler plusieurs methodes pour construire un traitement. Un stateless 
bean n'est pas dedie a un seul client et ne conserve pas d'etat (figure 5-1). 

Le client d'un EJB peut etre un programme de toute forme : une appli- 
cation avec ou sans interface graphique, une servlet, une JSP ou un autre 
EJB. Comme nous le verrons dans les prochains chapitres, les appels aux 
EJB, dans l'application YAPS Pet Store, seront effectues par le client 
graphique Swing et le client web (au travers de JSF). Cette couche de 
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traitements, inspiree du design pattern Facade, agit done comme un 
point d'entree unique pour les differents clients. 



Le design pattern Facade 

Le design pattern Facade du GoF (Gang of Four) permet de foumir un 
point d'entree simple a un systeme complexe. II introduit une interface 
pour decoupler les relations entre deux systemes : dans notre cas, les 
interfaces graphiques et les objets persistants. Grace a ce design pat- 
tern, le code qui gere les appels aux differents objets est regroupe a un 
seul endroit et peut etre reutilise par differentes interfaces utilisateurs. 
Le succes de ce design pattern a son pendant pour les EJB oil la pro- 
blematique reside dans son insertion dans un environnement 



distribue : il s'agit du pattern SessionFacade. Comme les EJB s'exe- 
cutent dans un conteneur, les appels sont done realises a distance. 
C'est pourquoi les objets doivent etre serialises puis transmis a tra- 
vers un reseau. Le design pattern SessionFacade offre un point 
d'entree unique et permet done de limiter les appels distants. Dans 
notre architecture, les stateless session beans font office de Session- 
Facade et s'occupent de faire le lien entre les interfaces utilisateurs 
et les objets persistants. 



Exemple de stateless bean 

Pour developper un stateless bean, il faut une classe qui contienne le 
code metier et, au minimum, une interface permettant les appels. Dans 
l'exemple ci-apres, l'interface distante Customer-Remote definit une 
methode pour creer un nouveau client (createCustomer). La classe 
Customer-Bean, quant a elle, implemente cette interface en ajoutant du 
code metier pour manipuler les entities Customer et Address. 

Interface distante 

©Remote Q 

public interface CustomerRemote { 

Customer createCustomer(Customer customer, 

Address homeAddress) ; 

} 

Classe du stateless bean 
©Stateless © 

public class CustomerBeanimplements CustomerRemote© { 

@Persi stenceContext 

private EntityManager em; Q 

public Customer createCustomer(Customer customer, 

Address homeAddress) { 
customer . setHomeAddress (homeAddress) ; 
em.persist(customer) ; 0 
return customer; 0 

} 

// Autres methodes metier 

} 
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Remarque EJB ou stateless bean ? 

Le sigle EJB signifie Enterprise Java Bean et cor- 
respond aux differents composants de la plate- 
forme Java EE. Ce terme generique englobe les 
stateless beans qui peuvent etre appeles EJB state- 
less, stateless beans ou stateless session beans. 



Cet exemple de code represents le composant CustomerBean qui gere la 
creation d'un nouveau client. Tout d'abord, notez la presence de l'inter- 
face Customer-Remote. Celle-ci est annotee par @ j avax. ejb. Remote 0 qui 
signifie que toutes les methodes quelle declare (dans notre exemple 
createCustomer), peuvent etre appelees de maniere distante. La classe 
CustomerBean implemente cette interface 0 et est done contrainte 
d'ajouter du code metier a la methode createCustomer. II est interessant 
de constater l'utilisation de l'annotation @j avax. ejb. State! ess 0. Sans 
cette annotation, la classe CustomerBean serait consideree comme toute 
autre classe Java. Grace a elle, le conteneur d'EJB sait qu'il manipule un 
stateless bean. 

Attardons-nous maintenant sur Implementation de la methode 
createCustomer. Son role est de creer un nouveau client dans la base de 
donnees. Pour cela, cette methode prend en parametres les deux entities 
Customer et Address et utilise un EntityManager Q pour les persister 0 
(le role de 1'EntityManager sera detaille dans les prochains paragraphes). 
Une fois l'operation effectuee avec succes, i'entity Customer est retourne 
0 en resultat de la methode. 



Comment developper un stateless bean 

Dans le chapitre precedent, intitule Objets persistants, nous avons cons- 
tate que le developpement d'un entity etait relativement simple et sur- 
tout, identique a n'importe quelle classe Java (hormis 1'utilisation de 
quelques annotations). Pour un stateless bean, e'est tout aussi facile 
puisqu'il suffit de developper une classe ainsi qu'une ou deux interfaces. 



Les interfaces 



Java Passage par valeur et reference 

Le passage de parametres en local dans Java se 
fait presque toujours par reference. Seul un poin- 
teur (reference) vers un objet est passe a la 
methode. Par contre, les donnees de type primitif 
(byte, short, char...) sont passees par valeur, 
e'est-a-dire qu'une copie de la donnee est mise a 
disposition de la methode et non I'originale. 



Un stateless bean peut avoir une interface distante et/ou locale. L'inter- 
face distante (@ j avax . e j b . Remote) permet aux clients distants d'invoquer 
des methodes de l'EJB. Les parametres des methodes sont ainsi copies, 
serialises, puis transmis a l'EJB. On appelle ce mecanisme l'appel par 
valeur {call-by-value). 

Linterface locale (@j avax. ejb. Local) est utilisee par les objets residants 
dans la meme JVM que l'EJB. Les parametres des methodes ne sont pas 
recopies mais passes par reference {call-by-reference). 
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La plupart de nos stateless session beans utilisent les deux interfaces. En 
effet, l'application YAPS Pet Store est constitute d'une interface graphique 
de type client lourd (Swing), utilisee par les employes et qui s'appuiera sur 
les interfaces ©Remote, ainsi qu'une application web, hebergee sur le meme 
serveur que les EJB, qui, quant a elle, utilisera les interfaces ©Local . Les 
deux interfaces peuvent exposer des methodes differentes. 

Interface distante 

Linterface distante definit les methodes de l'EJB accessibles en dehors 
du conteneur (application Swing utilisee par l'employe). Cette interface 
est annotee par @j avax . e j b . Remote. 

Reprenons l'exemple du CustomerBean. Ci-apres le code de l'interface 
Customer-Remote : 

Interface distante 

©Remote 

public interface CustomerRemote { 

Customer createCustomer(Customer customer, 

Address homeAddress) ; 

} 

Comme vous pouvez le constater, cette interface ressemble de tres pres a 
n'importe quelle interface Java. La seule difference est la presence de 
l'annotation @j avax. ejb. Remote qui informe le conteneur que cette 
interface peut etre appelee de maniere distante. 

Les parametres des methodes distantes doivent etre serialisables pour 
etre vehicules a travers le reseau. Rappelez-vous que les entities que nous 
avons developpes implementent l'interface Serial izable. 

Code de l'annotation @javax.ejb. Remote 

package j avax. ejb; 
©Target ({TYPE}) ©Retention (RUNTIME) 
public ©interface Remote { 
Class[] value() default {}; 

} 



EJB Interface distante dans un cluster 

On utilise un cluster (groupe d'ordinateurs vu 
comme une seule machine) pour des raisons de 
performance, de repartition de charge, ou de tole- 
rance aux pannes. Dans ce cas, il est necessaire 
d'utiliser des interfaces distantes pour que les EJB 
puissent communiquer entre eux dans le cluster. 



EJB RemoteException 



Contrairement aux EJB 2.1 , les methodes n'ont pas 
besoin de lancer I'exception java.rmi. 
RemoteException. II est toujours possible de 
le faire, mais ce n'est plus obligatoire depuis la 
version 3.0 des EJB. 



EJB Les stateless beans 2.x 

Pour vous faire une idee des modifications appor- 
tees a la specification EJB, retrouvez en annexe le 
code source d'un stateless bean 2.1. 



Cette annotation s'applique a une classe. 



Specifie la liste des interfaces distantes sous 
forme de tableau de classes. Cet attribut est uti- 
lise si la classe du bean implemente plus d'une 
interface distante. 
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DTO : design pattern ou anti-pattern 



Aussi connu sous le nom de Value Object (VO), le design pattern Data 
Transfert Object (DTO) permet de transporter des donnees du client au ser- 
veur et inversement en reduisant les appels reseaux. Ce design pattern est 
communement utilise dans les architectures EJB 2.x. En effet, les entity 
beans etant representee par des composants riches (heavyweight), qui ne 
sont pas serialisables- rappelez-vous les interfaces javax.ejb.EJBLocalHome 
ou j avax.ejb.E J BLocal Object- il est impossible de les manipuler en 
dehors du conteneur. Les objets DTO, composes uniquement d'attributs et 
d'accesseurs, collectent des donnees de plusieurs entity beans pour en 
obtenir une vision uniforme et permettre leur manipulation par des state- 
less beans. Depourvus d'acces a des ressources externes, de logique metier, 
ou de persistance, ces DTO sont charges a partir des attributs des entity 
beans, puis transmis au client pour enfin revenir au serveur. Ainsi, avec un 
seul appel distant, on obtient un DTO qui contient toutes les informations 
souhaitees. 

Ce design pattern peut maintenant etre vu comme un anti-pattern dans 
I'architecture EJB 3 s'il est utilise constamment. Comme nous I'avons vu, 
un entity est maintenant une simple classe Java et peut etre facilement 
manipule comme tel. De plus, comme nous allons le voir, les entities 
peuvent etre detaches de leur gestionnaire de persistance pour tra- 
verser les differentes couches de I'application et, etre vus comme de sim- 
ples Pojo. 

Bien entendu, le design pattern DTO peut toujours etre utilise dans cer- 
tains cas, comme celui des services web, qui doivent fournir une inter- 
face stable (evoluant moins rapidement que celle des EJB). II n'est plus 
une piece indispensable de I'architecture, mais tout simplement une 
solution supplementaire utilisable dans une situation particuliere. 

► http://java.sun.com/blueprints/corej2eepatterns/Patterns/TransferObject.html 

► http://c2.com/cg i/wi ki ?DataTra nsf erObject 



Approfondir Que signifie locale ? 



Interface locale 



Bien que nous n'ayons pas encore vu le deploie- 
ment de I'application, la notion d'interface locale 
est fortement liee a ce processus. L'application 
YAPS Pet Store va etre deployee dans un fichier 
ear (Enterprise Archive) qui contient tous les com- 
posants de I'application (EJB, application web, enti- 
ties...). L'interface locale d'un EJB est visible et 
utilisable a I'interieur de ce fichier ear. Si on 
deploie deux applications sur le meme serveur 
(A. ear et B.ear), l'interface locale d'un EJB 
dans A ne pourra pas etre vue par un EJB dans B. La 
visibilite n'est done pas directement liee au serveur 
d'applications mais a I'Enterprise Archive (ear). 



L'interface locale definit les methodes accessibles a I'interieur du serveur 
d'applications, e'est-a-dire par d'autres EJB ou applications web heber- 
gees sur le meme serveur. Cette interface permet les appels locaux sans 
rajouter de surcout lie a la serialisation des parametres qui devient alors 
inutile. Cette interface est identifiee par 1' annotation Ojavax.ejb. Local. 
Ci-apres, l'interface CustomerLocal definissant la meme methode pour 
creer un client. 



Interface locale 



©Local 

public interface Customer-Local { 



Customer createCustomer(Customer customer, 
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Comme vous pouvez le constater, le code est identique a celui de l'inter- 
face distante. La seule difference reside dans l'utilisation de l'annotation 
©Local au lieu de ©Remote. 

Code de l'annotation @javax.ejb.Local 

package javax.ejb; 
©Target ({TYPE}) @Retention(RUNTIME) 
public ©interface Local { 
Class [] valueO default {}; 

} 



Cette annotation s'applique a une classe. 



Specifie la liste des interfaces locales sous forme 
de tableau de classes. Cet attribut est utilise si la 
classe du bean implemente plus d'une interface 
locale. 



La classe de PEJB 



Cette classe contient la logique metier du composant et doit avoir au 
moins une interface. Si la classe implemente les deux interfaces, cela 
signifie que le meme EJB peut etre appele de maniere locale et distante. 
Dans les deux cas, le client de l'EJB n'utilise pas directement cette classe, 
mais doit passer par une des interfaces. 

La classe d'implementation du bean 

©Stateless 

public class CustomerBean implements CustomerRemote , 

Customer Local { 

©Persi stenceContext 
private EntityManager em; 

public Customer createCustomer (Customer customer, 

Address homeAddress) { 

customer . setHomeAddress(homeAddress) ; 
em . persi st (customer) ; 
return customer; 

} 

// Autres methodes metier 

} 

Comme vous le voyez ci-dessus, pour distinguer un Pojo d'un EJB state- 
less, il faut utiliser l'annotation ©javax.ejb. Stateless. Dans cet 
exemple, la classe implemente les deux interfaces et doit done definir la 
methode createCustomer. 



Syntaxe Classe EJB 



La classe de l'EJB doit suivre les regies de develop- 
pement suivantes : 

• elle doit etre annotee par ©Statel ess ; 

• elle doit etre publique ; 

• elle ne doit pas etre finale ; 

• elle ne doit pas etre abstraite ; 

• elle ne doit pas definir la methode 
f i nal i ze ; 

• elle doit avoir un constructeur par defaut ; 

• elle doit implementer les methodes de ses inter- 
faces. 
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Cette annotation s'applique a une classe. 



Norn de I'EJB. Par defaut, le nom est celui de la 
classe. 



Cet attribut represente le nom donne a I'EJB a 
I'interieur du conteneur. II est specifique a cha- 
que serveur d'applications et peut done ne pas 
etre portable. 



Description du stateless session bean. 



EJB UnnomJNDI 

Nous developperons I'utilisation et le fonctionne- 
ment de JNDI au chapitre suivant, Execution de 
/'application. Je tiens juste a vous faire remar- 
quer que pour modifier le nom JNDI par defaut de 
I'EJB dans GlassFish, il faut utiliser I'attribut 
mappedName de I'annotation ©Statel ess. Le 
code ci-dessous attribue le nom ejb/ 
statel ess/Customer au CustomerBean. 

©Stateless (mappedName = 

"ejb/statel ess/Customer") 

public class CustomerBean {} 



Code de I'annotation @javax.ejb.Stateless 

package javax.ejb; 

©Target (value = {TYPE}) ©Retention (value = RUNTIME) 
public ©interface Stateless { 
String name() default ""; 

String mappedNameQ default ""; 



String description() default ""; 

} 

La classe de notre exemple precedent implemente les deux interfaces. 
En EJB 3.0, la classe a le choix entre implementer les interfaces, ou les 
definir grace aux annotations ©Remote et ©Local. 

©Remote (val ue = CustomerRemote. class) 
©Local (value = Customer Local .class) 

©Stateless 

public class CustomerBean { 
(...) 

} 

L'avantage d'implementer les interfaces est que le compilateur peut deceler 
les methodes qui seraient definies dans les interfaces mais pas dans la 
classe d'implementation. Cela reduit done les erreurs de deploiement. 



Entity manager 

Comme enonce en introduction de ce chapitre, un des roles de la couche 
de traitements est de manipuler les entities. Ceux-ci sont de simples 
classes Java que Ton peut instancier a l'aide de l'operateur new. En 
revanche, quand on veut les persister en base de donnees, il faut utiliser 
un entity manager. 

Pour ceux d'entre vous qui ont deja manipule les entity beans 2.x, vous 
vous souvenez peut-etre qu'ils utilisent une Home Interface. Cette inter- 
face permet de creer, mettre a jour et supprimer les entities de la base de 
donnees. En EJB 3, les entities sont de simples Pojo et n'implementent 
aucune interface. II leur faut done utiliser les services de la classe 
j avax . pe rsi stence . Enti tyManage r. 
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Dans JPA, l'entity manager est le service centralisant toutes les actions 
de persistance. Les entities ne deviennent persistants que lorsqu'on le 
precise explicitement dans le code au travers de 1'entity manager. Celui- 
ci fournit une API pour creer, rechercher, mettre a jour, supprimer et 
synchroniser des objets avec la base de donnees. En fait, l'entity manager 
peut etre vu comme un DAO (Data Access Object) generique : il permet 
d'effectuer les methodes CRUD sur n'importe quel entity. 

Pour instancier un entity en memoire, il faut utiliser le mot-cle new. 
Ensuite, pour que les donnees soient stockees en base, il faut utiliser la 
methode persi st() © de l'entity manager ©. 

Utilisation de l'entity manager dans un stateless bean 

©Stateless 

public class Customer-Bean implements CustomerRemote { 
@PersistenceContext (unitName = "petstorePU") Q 



private EntityManager em; Q 

public Customer createCustomer(Customer customer, 

Address homeAddress) { 
customer . setHomeAdd res s(homeAddress) ; 



em.persist(customer) ; Q 

return customer; 



} 
} 

Lorsqu'un entity est pris en compte par l'entity manager, on dit qu'il est 
attache (ou manage). On peut alors effectuer des operations de persis- 
tance. L'entity manager synchronise automatiquement l'etat de 1'entity 
avec la base de donnees. Lorsque l'entity se detache (il n'est plus pris en 
compte par l'entity manager), il devient un simple Pojo et peut ainsi etre 
utilise par les autres couches (par le client Swing, par exemple). 



Approfondir JPA hors conteneur 

La classe EntityManager peut etre utilisee en 
dehors d'un conteneur dans une application 
Java SE. La seule difference est I'utilisation d'une 
classe Factory (Enti tyManagerFactory). 
Hormis cette classe, le code est identique en 
Java EE ou en Java SE. 
► http://www.oracle.com/technology/ 

products/ias/toplink/jpa/howto/ 

java-se-usage.html 



Le contexte de persistance informe l'entity 
manager du type de base de donnees et des 
parametres de connexion. 



Declaration de l'entity manager. 



L'entity manager est utilise pour persister l'entity 
customer dans la base de donnees. 



Contexte de persistance 

L'entity manager est la piece centrale servant a manipuler les entities. 
Grace aux annotations JPA, il sait comment faire le mapping entre un 
entity et une table et, plus precisement, entre un attribut et une colonne. 
Par contre, il lui manque toujours une information : dans quelle base de 
donnees doit-il persister ces entities ? 

Pour cela, il utilise un contexte de persistance Q qui le renseigne sur plu- 
sieurs informations : le type de la base de donnees (dans notre cas, on 
utilise Derby) et les parametres de connexion a cette base de donnees 
(via I'utilisation d'une source de donnees). 



Rappel Source de donnees 



Une source de donnees, ou Data Source, repre- 
sente une connexion physique a une base. Lorsque 
nous avons configure le serveur GlassFish, nous 
avons cree la source de donnees jdbc/ 
petstoreDS qui pointe vers la base 
petstoreDFJ dans Derby. 
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Remarquez l'annotation @javax. persistence. Persi stenceContext Q 
apposee sur l'entity manager. Grace a l'attribut unitName 
"petstorePU", l'entity manager sait faire le lien avec une unite de persis- 
tance qui se nomme petstorePU. Cette unite de persistance est definie 
dans le fichier persi stence.xml. Comme nous le verrons plus loin, ce 
fichier doit etre deploye dans le meme jar que les entities. 

Unite de persistance decrit dans le fichier persistence.xml 

<?xml version="1.0" encodi ng="UTF-8"?> 
<persistence> 

<persi stence-unit name="petstorePU"> O 

<jta-data-source>jdbc/petstoreDS</jta-data-source> 0 

<properties> 0 

<property name="toplink. target-database" val ue="Derby"/> 
</properties> 

</persi stence-uni t> 
</persi stence> 

L'attribut name © de la balise <persi stence-uni t> est la reference utilisee 
dans le stateless bean Q. Elle permet a l'EJB de connaitre le type de la 
base de donnees 0, c'est-a-dire Derby, et la maniere de s'y connecter 0 
(via l'utilisation de la source de donnees jdbc/petstoreDS que nous avons 
creee dans GlassFish). 



Manipuler les entities 

L'interface javax.persistence.EntityManager fournit une API pour 
manipuler les entities. Void un extrait ci-apres presentant les principales 
methodes que nous utiliserons dans la suite de ce chapitre. 

Extrait de I'API de l'entity manager 

package javax. persi stence ; 
public interface EntityManager { 

void persist(Object object); 

<T> T merge (T t) ; 

void remove (Object object); 

<T> T find(Class<T> aClass, Object object); 

void f"lush() ; 

void clearO ; 

Query createQuery(Stri ng query); 

} 
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Les methodes persist, merge, remove, find, flush et clear permettent 
de manipuler un entity. createQuery est utilisee pour faire des requetes 
sur des objets. Detaillons comment utiliser cette API. 

Persister un entity 

Persister un entity signifie que les valeurs des attributs sont stockes en 
base de donnees. On persiste des entites qui n' existent pas en base, 
sinon, on les met a jour. Pour ce faire, il faut creer une nouvelle instance 
de l'entite a l'aide de l'operateur new Q, affecter les valeurs grace aux 
methodes set 0, lier un entity a un autre lorsqu'il y a des associations, et 
enfin, appeler la methode EntityManager.persistO 0. 

Exemple simple de persistance d'un objet 

Customer customer = new CustomerO; O 
customer. setld(1234) ; 
customer. setFi rstname("Paul ") ; 0 
customer. setLastname("Dupond") ; 
em.persist(customer) ; 0 

Vous l'aurez compris, l'objet Customer etant un entity, il definit sa stra- 
tegic de mapping (grace aux annotations que nous avons vues dans le 
precedent chapitre) et saura persister ses attributs dans la table adequate. 

Revenons a nos stateless beans. Dans notre architecture distribute, ce 
sont les interfaces graphiques qui effectuent les new et les affectations de 
valeurs. Le role du stateless bean est done de recuperer des objets deja 
initialises et de les persister. 

Creation d'un client dans un stateless bean 

public Customer createCustomer(Customer customer, 0 

Address homeAddress) { 

customer. setHomeAddress(homeAddress) ; 0 
em.persist(customer) ; 0 
return customer; 

} 

Dans le code ci-dessus, la methode permettant de creer un client possede 
deux entities en parametres : un client et une adresse. Ces deux entities ont 
ete instancies par une application cliente (Swing, par exemple), qui a 
affecte les valeurs a l'aide des setters. L'appel a l'EJB est effectue en passant 
ces entities en parametres 0. Ensuite, le stateless bean a en charge de 
relier les beans entre eux 0 et de les persister 0 a l'aide de 1'entity 
manager (la variable em). A ce moment la, l'objet Customer devient 
manage (attache) et done eligible pour etre insere en base. 



Persistance Insertion en cascade 

Si vous vous reportez au code de I'entity 
Customer, vous verrez qu'il utilise une relation 
en cascade avec I'adresse. CascadeType.ALL 
englobe le mode CascadeType . PERSIST. 
Ceci signifie que lorsqu'on insere un client, son 
adresse est aussi automatiquement inseree. Si ce 
n'avait pas ete le cas, nous aurions du persister 
I'adresse, puis le client comme ceci : 

em.persist(address) ; 

customer. setHomeAddress (address) ; 

em.persist(customer) ; 
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Rechercher un entity par son identifiant 

Pour rechercher un entity par son identifiant, on utilise la methode 
EntityManager.findO. Cette methode prend en parametre la classe de 
1'entity ainsi que son identifiant et retourne un entity Q. Si celui-ci n'est 
pas trouve, la methode f i nd retourne la valeur null. 

Exemple de recherche d'un objet apres creation 

Customer customer = new CustomerO; 
customer. setld(1234) ; 
customer . setFi rst name ("Paul ") ; 
customer . setl_astname("Dupond") ; 
em.persist(customer) ; 

customer = em. find(Customer . class, 1234) 0 

Pour rechercher un client, le stateless bean doit declarer une methode 
(fi ndCustomer dans notre exemple) qui prend en parametre un identi- 
fiant © et retourne un entity © (cette valeur de retour peut etre egale a 
null si l'objet n'est pas trouve). La recherche s'effectue via l'appel de la 
methode f i nd de 1'entity manager Q. 

Recherche d'un client dans un stateless bean 

public Customer Q fi ndCustomer(Long customerld Q ) { 

Customer customer = em. find(Customer . class, customerld); Q 
return customer; 

} 

Rattacher un entity 

Si vous vous reportez au cycle de vie des entities que nous avons decrit 
dans le precedent chapitre, vous verrez qu'un entity peut etre attache 
(manage) ou detache. Lorsqu'il est manipule par une application gra- 
phique par exemple, il est detache de sa persistance. De retour sur le ser- 
veur, il doit etre rattache a 1'entity manager pour resynchroniser ses 
donnees avec la base. Pour ce faire, il suffit d'utiliser la methode 
EntityManager.mergeO qui prend en parametre 1'entity a rattacher. 

Exemple simple de rattachement d'un objet 

em. merge (customer) 



Mettre a jour un entity 



La mise a jour d'un entity est a la fois tres simple a mettre en oeuvre mais 
parfois difficile a comprendre car elle n'implique pas directement l'entity 
manager. Rien ne vaut un exemple. Le code ci-apres recherche un 
entity Q et met a jour ses attributs en utilisant les methodes set 0. 

Exemple de mise a jour d'un objet apres recherche 

Customer customer = em. find (Customer. class, 1234); 0 
customer. setFirstname("Antonio") ; 0 
customer. set Lastname("Gonca"l ves") ; 

La mise a jour est faite. Tout simplement. II n'y a pas de mot-cle parti- 
culier pour mettre a jour les donnees d'un entity : apres avoir effectue le 
find, le bean est toujours manage par l'entity manager. En appelant les 
methodes set, qui mettent a jour les attributs du bean, l'entity manager 
sait qu'il doit synchroniser ces changements avec la base de donnees car 
le contexte de persistance est toujours actif. 

Pour illustrer ce comportement, imaginez qu'apres le f i nd on reinitialise 0 
le contexte de persistance (EntityManager.c1ear()). L'entity n'etant plus 
manage, l'appel aux methodes set mettra a jour les attributs de l'objet, mais 
ces mises a jour ne seront pas synchronisees dans la base de donnees. 

Exemple de mise a jour qui echoue 

Customer customer = em. find (Customer. class, 1234); 
em.clear() ; 0 

customer. setFi rstname("Antonio") ; 
customer. setLastname("Gonca"l ves") ; 

Revenons a notre stateless bean. Les entities sont instancies et leurs 
attributs mis a jour par les interfaces graphiques. L'appel aux methodes 
set s'effectue done sur des entities detaches. Comment rendre effectifs 
ces changements ? Tout simplement en rattachant l'entity a l'aide de la 
methode EntityManager.merge(). 

Dans le code suivant, la methode pour mettre a jour un client possede 
deux parametres : un entity Customer et un entity Address. Les attributs 
de ces deux entities ont ete mis a jour par l'application cliente a l'aide des 
setters. L'appel a l'EJB est effectue en passant ces entities en parametres 
0. Ensuite, le stateless bean a en charge de relier les beans entre eux 0 
et de les rattacher 0 a l'entity manager qui synchronisera les change- 
ments en base de donnees. 



Persistance 

Avantages des outils de mapping 

Pour manipuler les entities, nous n'avons ecrit 
aucun ordre SQL. Dans I'exemple de la mise a jour, 
on voit bien qu'il est plus facile d'appeler une 
methode set plutot que d'ecrire un ordre SQL 
update. 
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Persistance Synchronisation 
avec la base de donnees 

Lorsque vous appelez les methodes persistO, 
merge() ou removeO, I'entity manager peut, 
soit agir immediatement sur la base de donnees, 
soit differer cette action a un moment qu'il juge 
opportun. Vous pouvez neanmoins forcer cette 
synchronisation en appelant la methode 
flushQ. 



Persistance Les langages de requetes 

Les bases de donnees relationnelles utilisent le 
Standard Query Language (SQL). 

► http://www.w3schools.com/sql/default.asp 
La version 2.x des entity beans utilise I'EJBQL 
[Enterprise Java Beans Query Language). 

► http://java.sun.com/j2ee/tutorial/1_3-fcs/ 
doc/EJBQL.html 

Mors que JPA utilise le Java Persistence Query 
Language (JPQL). 

► http://java.sun.eom/javaee/5/docs/tutorial/ 
doc/bnbtg.html 



Mise a jour d'un client dans un stateless bean 

public Customer updateCustomer(Customer customer, 0 

Address homeAddress) { 

customer. setHomeAddress(homeAddress) ; 0 
em.merge(customer) ; 0 
return customer; 

} 

Supprimer un entity 

Un entity peut etre supprime grace a la methode EntityManager. 
remove (). Cette derniere prend en parametre I'entity, et entraine la sup- 
pression des donnees en base. Une fois supprime, I'entity se detache de 
I'entity manager et ne peut plus etre manipule par ce dernier. Le code sui- 
vant nous montre comment supprimer un objet apres l'avoir trouve. 

Exemple de suppression d'un objet apres recherche 

customer = em. find(Customer. class, 1234) 
em. remove(customer) ; 

Revenons a notre architecture distribute. L'entity a supprimer se trouve 
dans la couche de presentation. Le client appelle le stateless bean en pas- 
sant I'entity en parametre. La suppression ne peut alors s'effectuer qu'en 
deux etapes : rattacher l'objet a I'entity manager via la methode merge, 
puis le supprimer en appelant la methode remove. Ce mecanisme est 
illustre dans la methode de l'EJB ci-dessous 0. 

Suppression d'un client dans un stateless bean 

public void del eteCustomer.Customer customer) { 
em.remove(em.merge(customer)) ; 0 

} 



Langage de requetes 

La possibilite d'effectuer des requetes est inherente aux bases de donnees 
relationnelles. Cela permet d'obtenir des informations repondant a cer- 
tains criteres, necessaires au systeme. SQL, ou Standard Query Language, 
est le langage standard d'interrogation de base de donnees. Les resultats 
obtenus sont sous forme de table, e'est-a-dire de lignes et de colonnes. 

JPA est une API de mapping objet-relationnel qui gere des objets et non 
des lignes et des colonnes. Pour conserver cette possibilite d'effectuer des 
requetes sur les entities, JPA utilise son propre langage : JPQL. 
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JPQL 



JPQL, ou Java Persistence Query Language, est un langage de requetes 
declaratif s'inspirant de la syntaxe de SQL. Sa particularite est de mani- 
puler des objets dans sa syntaxe de requete et de retourner des objets en 
resultat. On manipule done des objets dans une requete JPQL, puis le 
mecanisme de mapping transforme cette requete JPQL en langage com- 
prehensible par une base de donnees relationnelle (en SQL). 

Lavantage de JPQL est que le developpeur n'a pas a connaitre un nou- 
veau langage. Comme nous le verrons dans les exemples a venir, JPQL 
est plus intuitif pour un developpeur Java, car il utilise une approche 
objet. En effet, le developpeur manipule son modele objet, et non une 
structure de donnees, en utilisant la notation pointee (e'est-a-dire 
maCl asse . monAttri but). 

JPQL cree done une abstraction par rapport a la base de donnees. II est 
portable quel que soit le moteur utilise via son interface Query. Si vous 
souhaitez utiliser les specificites d'une base de donnees, JPQL vous 
permet de le faire en utilisant son interface Nati veQuery. 

Effectuer des requetes en JPQL 

Les requetes JPQL se font a l'aide de l'interface javax. persistence. 
Query. Cette interface est utilisee pour controler l'execution d'une requete 
JPQL. Lentity manager fabrique un objet Query a partir d'un ordre JQPL, 
et le retourne pour qu'il soit ensuite manipule par le programme. 

Dans l'exemple de code suivant, l'entity manager (variable em) cree une 
Query a l'aide d'une chaine de caracteres Q. Cette Query est ensuite uti- 
lisee pour passer des parametres a la requete © avant d'etre executee © 
et de retourner un entity. 

Query query = em.createQuery("SELECT c FROM Customer c Q 

WHERE c.login=:param") I 

query. setParameter ("param" , login); © 

Customer customer = (Customer) query. getSingleResultO ; © 

Regardons de plus pres cette chaine de caracteres. Celle-ci est constituee 
de trois mots-cles : SELECT, FROM et WHERE. lis permettent de selectionner 
un objet c de type Customer, dont 1'attribut login (c. login ou 
c.getLoginO) est egal a un parametre (: param - notez le prefixe ':'). Ce 
parametre, que Ton nomme arbitrairement param, est affecte dans la 
ligne suivante ©. La requete, ainsi constituee, est executee via la 
methode getSingleResult qui retourne un Object, lui-meme « caste » 
en Customer. Nous obtenons ainsi un entity Customer dont le login est 
egal a un parametre passe a cette methode. 



Persistance NativeQuery 

JPQL a une syntaxe tres riche qui vous permet de 
manipuler les objets sous toute forme, et cela, de 
maniere standard a toutes les bases de donnees. 
En revanche, si vous voulez utiliser une fonction- 
nalite proprietaire a une base de donnees, e'est-a- 
dire non portable, vous pouvez utiliser les Native- 
Query. Elles permettent de prendre avantage de 
ces particularity tout en continuant a manipuler 
des entities. 

Nous ne verrons pas de requetes natives dans ce 
livre. Vous pouvez consulter le lien suivant pour 
plus d'informations. 

► http://blogs.sun.com/JPQL01/entry/ 
native_q ueryj n Java_persistence 
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La requete retourne une liste d'objets. 



La requete retourne un objet unique. 



II existe plusieurs methodes pour passer des 
parametres a la requete. 



APPROFONDIR JPQL 



JPQL est decrit dans la specification de persistance 
EJB 3 et discute sur le site de Sun. 

► http://jcp.org/en/jsr/detail?id=220 

► http://wiki.java.net/bin/view/Javapedia/ 
JPQL 



Extrait de I'interface javax.persistence.Query 

package javax. persi stence ; 
public interface Query { 

List getResultListO ; 

Object getSingleResultO ; 

Query setParameter(Stri ng name, Object value); 
Query setParameter(Stri ng name, Date date, 

TemporalType temporalType) ; 
Query setParameter(Stri ng name, Calendar calendar, 

TemporalType temporalType); 

Query setParameter(i nt i, Object value); 
Query setParameter(i nt i, Date date, 

TemporalType temporalType); 
Query setParameter(i nt i, Calendar calendar, 

TemporalType temporalType); 

} 

JPQL est un langage extremement riche. II permet de faire toutes sortes 
de requetes sur un modele objet aussi complique soit-il (association entre 
classes, heritage, classe abstraite, interface...). On peut ainsi faire des 
jointures entre entities (LEFT JOIN, JOIN FETCH) ou effectuer des sous- 
requetes. Comme en SQL, il existe des operateurs pour filtrer les resul- 
tats (IN, NOT IN, EXIST, LIKE, IS NULL, IS NOT NULL), pour ne pas ramener 
de doublons (DISTINCT) ou pour controler la taille des collections (IS 
EMPTY, IS NOT EMPTY, CONTAINS). JPQL vient aussi avec toute une batterie 
de fonctions pour les chaines de caracteres (LOWER, UPPER, TRIM, CONCAT, 
LENGTH, SUBSTRING), les numeriques (ABS, SQRT, MOD), ou pour les ensem- 
bles (COUNT, MIN, MAX, SUM). Comme en SQL, on peut trier les resultats 
(ORDER BY) ou les regrouper (GROUP BY). 

JPQL meriterait un chapitre a lui tout seul, mais ce nest pas l'objet de ce 
livre. Nous allons done uniquement analyser les requetes utilisees dans 
notre application. 

Lapplication YAPS Pet Store a souvent besoin d'afficher la totalite des 
objets se trouvant dans la base de donnees (toutes les categories ou tous les 
clients). En JPQL, il suffit d'ecrire une requete sans restreindre le resultat 
(sans clause WHERE). Par exemple, pour avoir la liste de tous les clients : 

Query query = em . createQuery("SELECT c FROM Customer c") ; 

List<Customer> customers = query. getResultListO ; 

ou alors tous les clients tries par leur nom de famille. 

Query query = em.createQuery("SELECT c FROM Customer c 

ORDER BY c.lastname") ; 
List<Customer> customers = query. getResultListO ; 
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Exemples OrdresJQPL 



Voici quelques exemples d'ordres JPQL : 

select ol from Order ol, Order o2 where ol. quantity > o2. quantity 
select c from Customer c where p.fi rstname = 'Paul' 
select a from Address a where a. country in ('USA', 'PT', 'FR') 
select o from Order o where o.orderLines is empty 

La requete la plus compliquee de l'application concerne la recherche 
d'animaux domestiques. Si Ton se reporte au cas d'utilisation 
« Rechercher un article », il est stipule que Ton veut faire cette recherche 
a partir d'une chaine de caracteres saisie par l'internaute. La recherche 
ne doit pas tenir compte des minuscules ou majuscules, et doit porter sur 
le nom de l'article ou le nom du produit. Voici cette requete : 

Requete pour rechercher les articles 

Query query = em . createQuery("SELECT i FROM Item i WHERE Q 
UPPER(i . name) LIKE : keyword © 

OR UPPER(i .product. name) LIKE : keyword 0 



ORDER BY i .product. category. name, i .product. name") ; Q 



query. set Parameter ("keyword" , "%"+keyword.toUpperCase ()+"%") ; 0 



List<Item> items = query. getResul tLi st() ; 0 

On selectionne les articles O dont le nom Q, ou le nom du produit 0, res- 
semble (LIKE) a la chaine de caracteres passee en parametre 0. On utilise la 
fonction UPPER pour mettre le resultat en majuscules et le comparer a la 
chaine de caracteres de recherche, elle aussi passee en majuscules 
(keyword. toUpperCase()). Le resultat est trie sur le nom de la categorie 
puis le nom du produit ©, et retourne via la methode getResul tLi st() 0. 



Persistance Les jokers 



Tout comme SQL, JPQL peut aussi utiliser des 
« jokers » pour ses requetes. Le joker '%' remplace 
n'importe quelle chaine de caracteres, y compris la 
chaine vide. Le '_' remplace un et un seul caractere. 



On selectionne les articles (Item). 



On utilise la fonction UPPER et le mot-cle 
LIKE. 



Pour obtenir le nom du produit, on appelle les 
accesseurs de I'objet : 
item.getProductQ .getNameQ. 



Le tri est fait sur le nom de la categorie acces- 
sible par item.getProductO . 
getCategoryQ .getNameQ. 



On concatene le caractere '%' a I'operateur 
LIKE (parexemple, LIKE '%iche%' recu- 
pere les caniches). 



L' execution de la requete retourne une liste. 



Demarcation de transactions 

Comme nous venons de le voir, le stateless bean manipule les entities via 
l'entity manager (CRUD), et effectue des requetes en base de donnees 
via JPQL. Toutes ces actions engendrent des insertions, des mises a jour 
et des suppressions de donnees qui doivent etre coherentes. C'est done le 
role de l'EJB d'assurer une demarcation des transactions. 



Persistance Commit et rollback 

En SQL, rollback signifie que Ton restaure les don- 
nees d'une base a I'etat ou elles se trouvaient 
avant modifications. Ainsi, les dernieres modifica- 
tions sont annulees. A I'oppose, le commit permet 
de valider ces modifications, en laissant les don- 
nees de la base dans un etat coherent. 
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Demarquer explicitement une transaction consiste a indiquer quand elle 
debute (begin) et quand elle se termine (commit ou rollback en cas d'echec). 



Transactions 

On parle de transaction lorsqu'un certain nombre de taches doivent etre 
effectuees ensemble. Par exemple, pour creer un bon de commande, plu- 
sieurs entities (bon de commande, ligne de commande, adresse de 
livraison) doivent etre crees et done inseres en base de donnees. Ces inser- 
tions doivent toutes etre realisees afin d'eviter les incoherences de donnees. 
En cas de problemes d'acces aux donnees, on demande a la transaction de 
retrouver l'etat initial des donnees en annulant toutes les mises a jour. 



ACIDite 

On attend d'une transaction les proprietes d'ACIDite, e'est-a-dire : 

• (A)tomicite : une transaction doit etre entierement effectuee ou 
pas du tout. Par exemple, lors de la finalisation d'une commande, il 
est imperatif que la mise a jour de I'adresse de livraison et la vali- 
dation du paiement soient toutes les deux effectuees avec succes. 
Si une action echoue, alors I'autre ne doit pas etre executee. 

• (C)oherence : la coherence entre tables d'une meme base doit 
etre respectee, meme en cas d'incident. Par exemple, les con- 



traintes d'integrite entre cles primaires et cles etrangeres doivent 
etre respectees. 

• (l)solation si deux transactions T1 et T2 ont lieu simultanement, 
T1 ne doit pas voir les modifications de T2 tant que T2 n'a pas 
ete commitee, et inversement. 

• (D)urabilite : lorsque la transaction est achevee, les modifica- 
tions sont definitives. 

► http://java.sun.eom/javaee/5/docs/tutorial/doc/bncih.html 



PERSISTANCE Transactions explicites 

Si vous ne voulez pas laisser le conteneur gerer les 
transactions, vous pouvez le faire explicitement en 
utilisant JTA (Java Transaction API), specifica- 
tion Java EE definissant un modele de gestionnaire 
de transactions. 

► h tt p ://j a va . s u n . co m/p ro d u cts/j t a/ 



Avec Java EE, la gestion des transactions peut etre deleguee au 
conteneur : on parle alors de Container-Managed Transaction (CMT). 
Le developpeur n'a pas besoin d'utiliser d'API pour le faire. II est cepen- 
dant possible de declarer explicitement le mode transactionnel lorsqu'il 
est souhaite (Bean-Managed Transaction, ou BMT). 

Gestion des transactions par le conteneur 

Lorsque la gestion des transactions est laissee au soin du conteneur, il 
nest pas necessaire d'ecrire explicitement les begin, commit ou rollback. 
En annotant un stateless bean avec OTransactionAttri bute, le conteneur 
est informe de la politique transactionnelle a utiliser. Si le conteneur ne 
rencontre pas d'exceptions, il effectuera lui-meme le commit en respec- 
tant les parametres de l'annotation, sinon, il lancera un rollback. 

Prenons par exemple une methode d'un stateless bean. A l'appel de cette 
methode, une transaction demarre pour se terminer a la fin de l'execu- 
tion de cette meme methode. Que se passe-t-il maintenant si cette 
methode appelle une autre methode situee dans un autre stateless bean ? 
Cette seconde methode s'execute-t-elle dans la meme transaction que la 
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premiere ? Cree-t-on une nouvelle transaction ? Cela depend de l'anno- 
tation @javax.ejb.TransactionAttribute, qui est utilisee pour definir la 
politique transactionnelle et peut prendre les six valeurs suivantes : 

• REQUIRED : utilise la transaction si elle existe, sinon en demarre une 
nouvelle (valeur par defaut). 

• REQUIRES^NEW : demarre toujours une nouvelle transaction (suspend 
celle en cours si elle existe). 

• MANDATORY : necessite une transaction. Si l'appelant n'a pas de transac- 
tion, une exception est levee. 

• NOT_SUPPORTED : ne cree pas de transaction ni ne propage une transac- 
tion existante. 

• SUPPORTS : ne demarre aucune transaction, utilise celle qui est en cours. 

• NEVER : refuse toute transaction. Si l'appelant est dans une transac- 
tion, une exception est levee. 

Exemple de stateless bean utilisant differents modes de transaction 

©Stateless 

@Transacti onManagement (Transacti onManagementType . CONTAINER) Q 



@TransactionAttribute(val ue=TransactionAttri buteType . REQUIRED) 0 

public class CustomerBean implements CustomerRemote { 
@Persi stenceContext(unitName = "petstorePU") 
private EntityManager em; 

public Customer createCustomer(Customer customer, 

Address homeAddress) { 

customer . setHomeAdd res s (homeAddress) ; 
em. persi st(customer) ; 
return customer; 

} 

@TransactionAttribute(val ue = TransactionAttri buteType .NEVER) © 
public Customer f i ndCustomer(f i nal Long customerld) { 



} 



Customer customer 
return customer; 



em. find(Customer. class, customerld) ; 



} 



L'EJB CustomerBean commence par indiquer que les transactions doivent 
etre gerees par le conteneur Q (CMT). Ensuite, comme on peut le voir 
dans le code precedent, l'annotation Transacti onAttribute peut etre 
utilisee a deux emplacements : 

• Sur la classe de l'EJB © : l'annotation definit alors le mode transac- 
tionnel a appliquer sur toutes les methodes de l'EJB. 

• Sur une methode © : elle specifie ce mode transactionnel pour une 
seule methode, ne tenant pas compte de l'annotation mere. 



APPROFONDIR Modes de transactions 

Les differents modes de transactions sont detailles 
sur le site de Sun : 

► http://java.sun.eom/javaee/5/docs/tutorial/ 
doc/bncih.html 



Par defaut, la gestion des transactions est geree 
par le conteneur (CONTAINER). Pour qu'elle 
soit geree explicitement par le developpeur, il 
faut utiliser BEAN. 



Placee sur l'EJB, cette annotation indique au 
conteneur que toutes les methodes utilisent le 
mode transactionnel REQUIRED. 

Cette methode est en mode REQUIRED. 



Cette methode redefinit sa police transaction- 
nelle. Elle ne tient pas compte du mode 
REQUIRED mais utilise NEVER. 



Persistance 

Transactions dans YAPS Pet Store 

L'application YAPS Pet Store n'a pas de specificites 
transactionnelles. Les stateless session beans utili- 
sent done la valeur par defaut, e'est-a-dire le mode 
REQUIRED. 
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LU 
UJ 

I 

1 Gestion des exceptions 

I Java propose un mecanisme de gestion d'exceptions, consistant a effec- 

^ tuer les instructions dans un bloc d'essai (le bloc try) qui surveille les 

"5 instructions. Lors de l'apparition d'une erreur, celle-ci est interceptee 

1 dans un bloc de traitement d'erreurs (le bloc catch) sous forme d'un 

S objet appele Exception. Ce bloc peut alors traiter l'erreur ou la relancer 

vers un bloc de plus haut niveau. 

Ce mecanisme de gestion d'exceptions du langage Java est utilise par les 
stateless beans. Par contre, la nouvelle specification des EJB 3 distingue 
les exceptions applicatives des exceptions systeme. 



Les exceptions 

En Java, les exceptions sont des objets, instances de java.lang. 
Throwable. Elles peuvent etre repertoriees en deux categories : exception 
controlee et exception non controlee. 

• Les exceptions non controlees (unchecked exceptions) sont, en general, 
lancees par le systeme. Elles correspondent a des erreurs a I'execution et 
proviennent d'extensions de la classe java.lang.RuntimeException. 
Le compilateur java n'exige pas qu'elles soient declarees ou traitees par 
les methodes qui peuvent les lancer. 

• Les exceptions controlees (checked exceptions) correspondent a des 
exceptions creees par I'utilisateur et proviennent d'extensions de la 
classe java.lang. Exception. Le compilateur exige qu'une methode, 
dans laquelle une telle exception est lancee, declare cette exception 
dans sa signature, ou bien la traite. 



Exceptions d'application 

Les EJB utilisent les exceptions d'application pour informer un client 
qu'une anomalie applicative s'est produite (parametre invalide, numero 
de carte de credit errone, etc.). Ce type d'exception n'est pas fait pour 
remonter les problemes systeme (base de donnees indisponible, file 
d'attente JMS introuvable, etc.). 

Une exception d'application peut soit etre controlee (herite de la classe 
java.lang. Exception), soit non controlee (herite alors de la classe 
java.lang.RuntimeException). En revanche, elle ne doit heriter ni de 
java. rmi . RemoteException ni de javax.ejb.EJBException, qui sont 
reservees aux exceptions systeme. Sa seule particularite est quelle doit 
etre annotee par @Appl i cati onExcepti on. 

Lorsqu'une exception d'application est lancee par une methode d'EJB, le 
conteneur l'intercepte et peut alors decider de « rollbacker » la transac- 
tion ou non. Ce choix est laisse au developpeur. En effet, 1' annotation 
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@Appli cation Exception possede un attribut rollback qui, positionne a 
true, informe le conteneur de l'annulation de la transaction. 

Code de I'annotation @javax.ejb.Application Exception 

package javax.ejb; 

©Target (val ue = {TYPE}) ©Retention (value = RUNTIME) < | Cette annotation s'applique a une classe. 

public ©interface Appl icationException { 

boolean rollback() default false; < 

} 

L'application YAPS Pet Store utilise certaines de ces exceptions applica- 
tives, par exemple, pour la validation des cartes de credit. Lorsque le 
client desire acheter des animaux domestiques, il doit saisir son numero 
de carte. Ce dernier est analyse par le service web de la banque Bark- 
Bank (detaille dans le chapitre 9, Echanges B2B). Si la carte est refusee, 
l'application lance une CreditCardException et il faut alors « rollbacker » 
les mises a jour qui auraient pu etre faites dans la base de donnees. 

Exception applicative CreditCardException 

@App"licationException(ro"llback = true) 

public class CreditCardException extends RuntimeException { 

public CreditCardException(Stri ng message) { 
super(message) ; 

} 

} 

Dans le chapitre precedent, Objets persistants, nous avons vu que les entities 
validaient leurs attributs avant d'etre persisted. Si une valeur est invalide, une 
ValidationException est lancee avec le parametre rollback a true. 

Entity Category validant ses attributs 

©Entity 

public class Category 
(...) 

©PrePersi st 
©PreUpdate 

private void validateData() { 

if (name == null || "".equals(name)) 

throw new Val idationException("Inval i d name") ; 
if (description == null | | "".equals(description)) 

throw new Val idationException("Inval i d description"); 

} 

} 
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Specifie si le conteneur doit ou non rollbacker la 
transaction en cours. Par defaut, la valeur est 
false. 



Exception applicative Validation Exception 



OAppl icationExceptionCroll back = true) 

public class ValidationException extends RuntimeException { 

public ValidationException(String message) { 
super(message) ; 

} 

} 



Exception systeme 

Une exception systeme est lancee lorsqu'une ressource systeme dysfonc- 
tionne (base de donnees indisponible, etc.). Ces exceptions ne sont pas 
attendues par l'appiication qui, la plupart du temps, ne sait pas comment 
les traiter. On peut done laisser ces exceptions se propager pour enfin 
etre interceptees par le conteneur. Le conteneur effectuera automatique- 
ment un rollback sur la transaction et detruira le stateless bean. 

Les exceptions de type systeme heritent de java.rmi . RemoteException, 
javax.ejb.EJBException ou de java.lang. RuntimeException (mais sans 
utiliser 1' annotation OApplicationException). II est important de com- 
prendre que des exceptions non controlees peuvent etre lancees par 
d'autres systemes et qu'elles n'ont rien a voir avec la modelisation d'un 
EJB metier. Elles ne doivent done generalement pas apparaitre dans la 
signature des methodes. En revanche, pour les exceptions controlees 
(telles que javax. jms . JMSException), l'EJB est oblige de les « catcher ». 
Une bonne pratique consiste a encapsuler ce type d'exception dans une 
EJBException et la relancer. Le conteneur pourra alors la traiter comme 
une exception systeme et appliquer la politique transactionnelle. 

Exemple de traitement d'exception J MS 

public void publ i sh0rder(0rder order) { 
try { 

Session session = connection. createSession(true, 0); 
(...) 

ObjectMessage objectMessage = session. createObjectMessageO ; 
objectMessage.setObject(order) ; 
producer . send(objectMessage) ; 
} catch (JMSException e) { 
throw new EJBException(e) ; 

} 

} 



Le cycle de vie (Tun stateless bean 



Le cycle de vie d'un stateless bean est tres simple. En fait, il n'a que deux 
etats : soit il existe, soit il n'existe pas. L'etat inexistant signifie que l'EJB 
n'a pas encore ete instancie par le conteneur et n'existe pas en memoire. 
Le passage a l'etat pret se fait lorsque le client invoque un EJB. Le con- 
teneur cree alors une nouvelle instance et appelle la methode demandee. 



Instantiation du composant 



@P ostConstruct 



@PreDestmy 



Appel d'une methode metier 



Figure 5-2 

Cycle de vie d'un stateless bean 



Le passage d'un etat a l'autre peut etre intercepte grace aux annotations 
de callback. 



EJB Les stateless stockes dans un pool 

Bien que les specifications n'obligent pas les conte- 
neurs a avoir un pool de stateless beans, la plupart 
des serveurs d'applications en utilise un pour aug- 
menter les performances. Cela evite de creer et de 
detruire un EJB a chaque appel, puisque le conteneur 
n'a qu'a piocher dans son pool pour reutiliser le pre- 
mier stateless disponible. Au demarrage, le conte- 
neur cree un certain nombre de stateless beans et les 
stocke dans un pool. Si, a un moment donne, aucun 
n'est disponible, le conteneur en instancie de nou- 
veaux pour effectuer des traitements. Au contraire, 
lorsque le conteneur a besoin de liberer de la 
memoire, il supprime certains EJB du pool. 
GlassFish utilise ce mecanisme de pool. La taille de 
ce pool est parametrable, tout comme sa taille mini- 
male et maximale. Cette configuration est faite via 
la console d'administration (menu 
Configuration>EJB Container> 
EJB Settings). 



Les annotations de callback 



Grace aux annotations de callback, le conteneur d'EJB laisse la possibilite 
aux developpeurs d'effectuer des traitements lors du passage d'un etat a un 
autre. II existe deux annotations utilisables par les stateless beans : 

• @javax . annotation . PostConstruct 

• ©javax. annotation . PreDestroy 

Apres avoir instancie un stateless bean, le conteneur execute les 
methodes annotees par ©PostConstruct. Dans le cas inverse, l'annota- 
tion ©PreDestroy est appelee lorsque le conteneur supprime l'EJB de la 
memoire. Ces annotations sont importantes lorsque, par exemple, un 
EJB utilise des ressources externes. Si l'initialisation et la liberation de 
ces ressources sont couteuses, il est preferable de les effectuer le moins 
souvent possible, c'est-a-dire une fois a la creation de l'EJB, et une fois a 
sa suppression. 

Dans l'exemple ci-apres, le stateless bean ouvre une connexion JMS dans 
la methode openConnection (annotee par ©PostConstruct) et la referme 
avant la suppression de l'EJB de la memoire (©PreDestroy). Ainsi, tout 
au long de la periode ou le stateless bean est dans l'etat pret, la con- 
nexion reste ouverte et utilisable. 



Syntaxe Callback 



Une methode annotee par une annotation callback 
respecte les regies suivantes : 

• elle peut etre annotee par une ou plusieurs 
annotations de callback ; 

• elle ne peut lancer que des 
RuntimeException ; 

• elle peut etre public, package, 
protected ou private. 



Remarque Utilisation de JMS 

Ne vous inquietez pas si vous ne comprenez pas 
totalement le code d'appel a JMS. Les traitements 
asynchrones seront etudies de maniere approfondie 
au chapitre 10, Traitements asynchrones. 
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Le stateless bean utilise une connexion JMS. 



La connexion a JMS est ouverte apres I'instan- 
ciation de I'EJB par le conteneur. L'annotation 
@PostConstruct intercepte cet evenement 
et ouvre la connexion a JMS. 



A la destruction de I'EJB, le conteneur appelle 
cette methode qui referme la connexion a JMS. 



Stateless bean utilisant des annotations de callback 

©State! ess (mappedName = "ejb/stateless/Order") 

public class OrderBean implements OrderRemote, OrderLocal { 

private ConnectionFactory connectionFactory ; 

private Connection connection; 

(...) 

©PostConstruct 

public void openConnection() { 

connection = connectionFactory. createConnectionO ; 

} 



} 



©PreDestroy 

public void closeConnection() { 
if (connection != null) { 
connection. close() ; 

} 

} 



Les stateless beans de YAPS Pet Store 

Maintenant que nous avons vu le fonctionnement des EJB sans etat, 
voyons comment les utiliser dans notre application YAPS Pet Store. 

Contrairement aux entities qui representent les objets metier (identifia- 
bles par les mots des cas d'utilisation), les stateless beans representent les 
actions. lis se rapportent aux verbes des cas d'utilisation. Par exemple, 
creer un client, mettre a jour un client, rechercher un article, supprimer 
un bon de commande, etc. 

Un EJB ne represente pas une seule de ces actions, mais plusieurs regroupees 
au sein d'une meme classe. L'attribution de ces actions aux bonnes classes est 
l'un des problemes de la conception orientee objet. Pour chaque action, il 
nous faut decider dans quelle classe la mettre. Une erreur frequemment ren- 
contree consiste a definir un stateless bean pour chaque entity. Cette relation 
un pour un peut exister, mais ne doit pas etre la regie. 

L'application YAPS Pet Store utilise trois stateless beans : 

• CatalogBean pour la gestion du catalogue au sens large, c'est-a-dire 
les categories, les produits et les articles ; 

• CustomerBean pour la creation, mise a jour, suppression des clients 
ainsi que leur connexion au site marchand ; 

• OrderBean pour les bons de commande, les lignes de commandes et 
tout ce qui concerne le paiement par carte de credit (communication 
avec BarkBank) ainsi que l'acheminement (PetEx). 
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La gestion des clients 



Si on se reporte au cas d'utilisation « Gerer les clients », on s'apercoit 
que les employes de la societe doivent avoir la possibilite de creer, mettre 
a jour, supprimer et lister les clients de l'application. Leur interface gra- 
phique (Swing) etant distante, elle utilisera les methodes de l'interface 
CustomerRemote. 

Les clients, quant a eux, utilisent l'interface web pour se connecter au 
systeme, consulter et mettre a jour leurs coordonnees (cas d'utilisation 
« Consulter et modifier son compte »). L'application web etant deployee 
dans le meme ear que les stateless beans, elle utilise l'interface locale 
(CustomerLocal). 

Ci-apres, le diagramme de classes representant ces deux interfaces ainsi 
que la classe d'implementation (CustomerBean). Celle-ci utilise les enti- 
ties Customer et Address. 



UML Les classes 



En UML, une classe est representee par un rec- 
tangle, separe en trois parties : 

• la premiere partie contient le nom de la classe 
et un eventuel stereotype ; 

• la deuxieme contient les attributs de la classe ; 

• la derniere contient les methodes de la classe. 
On peut masquer ou non une de ces parties si on 
veut rendre un diagramme plus lisible ou si la 
classe en question ne contient ni attribut ni 
methode. 




Notez les differences entre les deux interfaces : l'interface CustomerLocal 
permet l'authentification (en effet, seule l'interface web le permet) alors 
que l'interface distante permet aux employes d'afficher la liste de tous les 
clients et d'en supprimer. 



CustomerLocal 

Les methodes referencees dans l'interface locale sont utilisables par 
l'interface web. Elles permettent au client de se creer un compte, de 
s'authentifier, de consulter et de mettre a jour ses informations. 
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Interface locale. 



Methodes utilisees par I'application web. 



©Local 

public interface Customer-Local { 

Customer authenticate(String login, String password); 
Customer createCustomer(Customer customer, Address address); 
Customer f i ndCustomer(Long customerld) ; 

Customer updateCustomer(Customer customer .Address address); 



CustomerRemote 



Interface distante. 



Methodes utilisees par I'application en client 
lourd. 



Les methodes de l'interface distante permettent aux employes de gerer 
les clients du systeme. 

©Remote 

public interface CustomerRemote { 

Customer createCustomer(Customer customer, Address address) ; 
Customer fi ndCustomer(Long customerld) ; 
void deleteCustomer(Customer customer) ; 

Customer updateCustomer(Customer customer, Address address) ; 
List<Customer> fi ndCustomersQ ; 



CustomerBean 

La classe d'implementation du stateless bean manipule les entities 
Customer et Address via l'entity manager et JPQL. 



La politique transactionnelle est celle par defaut. 



L'annotation Stateless identifie cette classe 
comme etant un stateless bean qui se nomme 
CustomerSB. 



Le bean implements l'interface locale et dis- 
tante. 



L'entity manager est lie au contexte de persis- 
tance "petstorePU" qui est defini dans le 
fichier persi stence . xml . 



Cette methode permet au client de s'authentifier 
a I'aide de son login et mot de passe. 



On s'assure de la validite du parametre login en 
lancant une exception si besoin. 



On recherche l'entity Customer a partir de son 
login grace a une requete JPQL. 



@TransactionAttribute(val ue= 
Transacti onAtt ri buteType . REQUIRED) 

©State! ess (name = "CustomerSB", 

mappedName = "ejb/stateless/Customer") 

public class CustomerBean implements CustomerRemote, 

CustomerLocal { 

@PersistenceContext(unitName = "petstorePU") 
private Enti tyManager em; 

public Customer authenticate(Stri ng login, String password) { 

if (login == null || "". equal s(logi n)) 

throw new Val idationException("Inval i d login"); 

Query query; 
Customer customer; 



132 



query = em. createQuery ("SELECT c FROM Customer c 

WHERE c.login=: "login") ; 
query. setParameter("logi n" , logi n) ; 
customer = (Customer) query. getSingleResult() ; 

if (customer != null) 

customer .matchPassword (password) ; 

return customer; 



} 



public Customer createCustomer (Customer customer, 

Address homeAddress) { 

if (customer == null) 
throw new ValidationException("Customer object is null"); 

customer . setHomeAdd res s (homeAddress) ; 
em.persist(customer) ; 

return customer; 



Si la recherche aboutit (I'objet customer est 
done different de nul 1), on appelle la methode 
metier matchPassword de I'entity. 



On retourne I'entity s'il a ete trouve. Sinon, cette 
methode renvoie la valeur nul 1 . 



On cree un client a partir des entities 
Customer et Address. 



On s'assure que I'entity Customer existe. En 
revanche, un client peut ne pas fournir 
d'adresse. 



On relie les entities entre eux. 



L'entity manager persiste le client dans la base 
de donnees. 



public Customer findCustomer (Long customerld) { 

if (customerld == null) 

throw new ValidationException("Invalid id"); 



A partir de son identifiant, cette methode 
retourne un entity Customer. 



Customer customer; 

customer = em. find(Customer. class, customerld); 
return customer; 



public void del eteCustomer (Customer customer) { 

if (customer == null) 
throw new ValidationException("Customer object is null"); 



Cette methode supprime le client passe en para- 
metre. 



} 



em. remove(em.merge(customer)) ; 



L'entity doit etre rattache (merge) avant de 
pouvoir etre supprime. 



public Customer updateCustomer (Customer customer, 

Address homeAddress) { 



< Cette methode met a jour les donnees du client. 



if (customer == null) 
throw new ValidationException("Customer object is null"); 

customer . setHomeAdd res s (homeAddress) ; 
em. merge (customer) ; 



L'appel au merge rattache l'entity au manager, 
et synchronise les eventuelles mises a jour. 
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Cette methode retourne la liste de tous les 
clients. 



Grace a une query JPQL, tous les entities 
Customer sont ramenes de la base de don- 
nees. 



return customer; 



public List<Customer> findCustomersQ { 



Query query; 

List<Customer> customers; 



query = em . createQuery("SELECT c FROM Customer c") I 
customers = query. getResultListQ ; 



return customers; 



UML Les differents liens 



En UML, les diagrammes de classes utilisenttoutes 
sortes de liens. L'image suivante represents de 
gauche a droite, un heritage, une implementation, 
une utilisation et une association. 



AAA 



Figure 5-4 Liens UML 



UML La visibility 
des attributs et methodes 

Les methodes et les attributs d'une classe utilisent 
differents modes de visibilite. Ceux-ci ont une 
representation graphique en UML : privee (-), pro- 
tegee (#), paquetage (~) et publique (+). 



privee 
flprotegee 
-paquetage 
+publique 



Figure 5-5 Visibilite en UML 



Figure 5-6 

Classe et interfaces 
du stateless bean catalogue 



La gestion du catalogue 

Le catalogue de YAPS est organise en categories, produits et articles. Pour 
pouvoir mettre a jour le catalogue, 1' application riche (Swing) doit per- 
mettre aux employes de mettre a jour chacun de ces elements. On retrouve 
ainsi des methodes CRUD pour la categorie, le produit et 1' article dans 
l'interface distante CatalogRemote. 

Le site web, quant a lui, ne permet pas les mises a jour, mais simplement la 
consultation du catalogue etla recherche d'articles (interface Catalog Local) 
par les clients et les internautes. 



[ 



catalog 

( com : : yaps: : petstoi e: : slate less) 



«interface» 



createCategoi '/(category : Category) : Category 
findC ate cion/ (cat eg oi : /ld : Long i : L ate gory 
c!eleteCategory( category : Category): void 
updateCategory(category : Category) : Category 
■findCategoriesO : List<Category> 

cieatePioduct(product : Product, category : Category) : Product 
findProduct(productld : Long) : Product 
deleteP toduddJiOLluot : Pioductj: ,oid 
|~updateProduct(product : Product, category : Category): Product 
|~findProductsO : List<Produd> 
•createltem(rtem : Item, product : Product) : Item 
-findltemOtemld : Long) : Item 
~deleteltem(item : Item) : void 
-updateltem(item : Item, product: Product): Item 
~findltems(): List<ltem> 

■ 

i 
i 
i 
i 
i 
i 



«interface» 



-flndCategory(categoryld : Long) : Category 
-findProduct(productld : Long) : Product 
-tindltemfltenild : Long) : Item 
~searchltems(keyw>rd : String) : List<ltem> 

Session Bean» 



« Session Bean» 



catalog 
(com::yaps::petstore::entity) 



«entity>> 
Category 



: 4 



«entity>> 
Product 



<entity» 
Item 
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Le stateless bean CatalogBean manipule les entities Category, Product et 
Item. 

CatalogBean 

Vous l'aurez compris, le code des methodes CRUD des elements du 
catalogue, ressemble de tres pres a celui du client que nous venons de 
voir. Toute description de ce code est done superflue. L'extrait de code 
ci-apres nous montre uniquement la methode de recherche des articles. 



©Transacti onAtt r i bute (val ue= 
Transact! onAtt ri buteType . REQUIRED) 

©State! ess (name = "CatalogSB", 

mappedName = "ejb/stateless/Catalog") 

public class CatalogBean implements 
Cata"logRemote,Catal og Local { 

©Persi stenceContext(unitName = "petstorePU") 
private EntityManager em; 

(...) 

public List<Item> searchItems(Stri ng keyword) { 
Query query; 
List<Item> items; 



< Le nom JNDI de I'EJB est "ejb/stateless/ 
Catalog". 



< Les autres methodes ne sont pas decrites. 

< Cette methode retrouve tous les articles dont le 
nom correspond au mot-cle passe en parametre. 



query = em. createQuery ("SELECT i FROM Item i WHERE 
UPPER(i .name) LIKE : keyword OR 
UPPER(i . product . name) LIKE : keyword 
ORDER BY i .product. category. name, i .product. name") ; 

query . setParameter("keyword" , 

"%" + keyword. toUpperCase() + "%") ; 
items = query . getResul tList() ; 

return items; 

} 

} 

La gestion des bons de commande 

Les bons de commande ne sont pas automatiquement crees par une 
interface graphique. C'est le processus d'achat d'animaux par le client 
qui declenche la creation d'un bon de commande et de toutes les actions 
qui en decoulent (envoyer un e-mail de confirmation au client, avertir le 
transporteur, etc.). 
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LU 
UJ 

g 
JO 

§ Ajout de trace 

i, La journalisation consiste a garder les traces des evenements survenus 

£ dans une application. Des fichiers de log au format predefini conservent 

des messages informant sur la date et I'heure de I'evenement, sa nature, 
.2 sa gravite, une description et d'autres informations : utilisateur, classe, 

3 etc. L'API java.util .logging, fournie par defaut depuis le JDK 1.4, 

J permet de journaliser des evenements dans un fichier texte ou XML, et 

utilise differents niveaux de severite. 

Dans I'architecture du YAPS Pet Store, toutes les actions passent par la 

couche de stateless beans (la facade). C'est done I'endroit ideal pour 

rajouter des traces dans le code. En utilisant I'API de logging, on peut 

ainsi delimiter I'entree (entering) et la sortie (exiting) d'une methode, 

ou bien rajouter des traces au milieu du code. 

Ci-apres un exemple de traces dans I'EJB OrderBean. 

public class OrderBean implements OrderRemote, OrderLocal { 

private Logger logger = Logger. getLogger( 

"com. yaps. petstore. stateless") ; Q 

private final String cname = this.getClass() .getName() I 

(...) 

public List<Order> findOrders() { 
final String mname = "findOrders"; 
logger. entering(cname, mname); Q 

Query query; 
List<Order> orders; 

logger .finest("Recherche les bons de commande") ; © 

query = em.createQueryC'SELECT o FROM Order o") ; 
orders = query. getResultList() ; 

logger .exiting (cname, mname, orders. size()) ; © 
return orders; 

} 

} 

Un logger © portant le nom de com. yaps. petstore. stateless est 
defini. II est ensuite utilise pour tracer I'entree © et la sortie © de la 
methode, tout comme pour ajouter des traces dans le code ©. 
II faut cependant faire attention au nombre de traces que vous ajoutez 
dans le code ainsi qu'a leur niveau de severite. II faut garder en tete 
que, potentiellement, une journalisation se solde par un acces disque 
pour ecrire dans un fichier. Cela peut done avoir des repercussions en 
termes de performances. Dans ce cas, veillez a profiter des differents 
niveaux de criticite pour renseigner a bon escient vos traces et definir 
correctement ce degre pour limiter le stockage sur disque. 

► http://www.onjava.eom/pub/a/onjava/2002/06/19/log.html 

► http://java.sun.eom/j2se/1 .5.0/docs/api/java/util/logging/ 
package-summary.html 
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Ci-apres le diagramme de classes du stateless bean agissant sur le bon de 
commande. 



«interface» 



■1indOrder(orderld : Long) : Order 
-deleteOrder(order : Order) : void 
•findOrdersO : List<Order> 



-validateCreditCard(CreditCardcreditCard) 
~createOrdei( Order order): Order 



« Session Bean» 
OrderBean 



-em : Entityf.lanaqer 



entity 
yaps:: pet store) 



<entity>> 
Custoniei 



«entity» 
Address 



«entity>> 
OrderLine 




:<entity» 
Order 



«entitv>> 
CreditCard 



UML Les stereotypes 



Les diagrammes de classes s'enrichissent ainsi que 
la palette de stereotypes. «interface» 
permet de typer une classe en tant qu'interface (en 
UML on peut aussi utiliser le rond pour representor 
une interface), «Session Bean» et 
«enti ty» sont utilises pour les EJB. 



Figure 5-7 

Diagramme des classes interagissant 
avec la gestion du bon de commande 



Les methodes du bon de commande etant etroitement liees au panier 
electro nique, leurs implementations seront decrites dans le chapitre 8, 
intitule Gestion du panier electronique. 

Paquetages des stateless beans 

Les interfaces et classes des stateless beans (client, catalogue et bon de 
commande) sontplacees dans les sous-paquetages de com. yaps. petstore. 
stateless. Les exceptions lancees dans les EJB (Val idationException et 
CreditCardException), se trouvent dans com. yaps . petstore. exception. 



Architecture 

Larchitecture globale obtenue jusqu'a present, est principalement cons- 
titute de stateless et d'entities. La couche de stateless forme le point 
d'entree, c'est-a-dire la facade de 1' application et publie des methodes 
pour les interfaces graphiques. Cette couche s'appuie ensuite sur les enti- 
ties qui representent le modele persistant de l'application. 

La couche des stateless beans est constitute de trois EJB permettant la ges- 
tion du catalogue (CatalogBean), des clients (CustomerBean) et desbons de 
commande (OrderBean). Chacun publie ses methodes a l'aide d'interfaces 
locales et distantes. Les stateless beans interagissent avec les entities. 



-- i.. cum 

fe- ©yaps 

fe- §y petstore 
ffl- EU entity 
^- S/ exception 

?' ^ CreditCardException 
■ <& Tm ValidationExcepcion 
fe- S/ stateless 
^- S/ catalog 

- CatalogBean 

- ■ I) It CatalogLocal 
$ ^ CatalogRemote 

£h Sj customer 

- 'C) fa CustomerBean 
■ I 7v Customer Local 

- I 7v CustomerRemote 
k- E£ order 

- \C) fa OrderBean 

- $ fa OrderLocal 

- '1) fa OrderRemote 

Figure 5-8 Stateless beans et exceptions 



UML Les composants 

Les composants, en UML, sont represented par le 
stereotype «component». lis publient une ou 
plusieurs interfaces representees par un cercle. 



Figure 5-9 Composant et interface 
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Figure 5-10 

Architecture globale du YAPS Pet Store 



O- 

Loc.il 

o- 



«component>> j^J 
Catalog ean 



entity 



«entity>> 




«entity>> 


Category 




Product 



0..* 


«entity» 




Item 




En resume 

Les stateless beans forment une couche de traitements metier qui sera 
invoquee par les interfaces graphiques. lis manipulent les entities, assu- 
rent la coherence des donnees grace aux transactions, et sont accessibles 
de maniere locale ou distante. La specification EJB 3 simplifie grande- 
ment leur developpement via l'utilisation des annotations. Piece incon- 
tournable de Java EE, les EJB seront deployes sur le serveur GlassFish 
dans le prochain chapitre et seront utilises a l'aide d'une application dis- 
tante Swing. 
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chapitre 
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List categories 
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Manage product 
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Les couches de persistance et de traitements metier ont ete 
developpees dans les precedents chapitres. II reste maintenant 
a y acceder au travers d'une application cliente. Ce chapitre 
nous explique comment compiler l'application YAPS 
Pet Store, la packager et la deployer sur le serveur GlassFish. 
L'interface utilisateur Swing accedera de maniere distante aux 
stateless beans en utilisant JNDI. 



Les objets persistants et la couche metier ont ete developpes dans les 
precedents chapitres. Ces composants serveurs doivent maintenant etre 
compiles puis deployes sur GlassFish pour pouvoir etre interroges par 
Implication graphique. Ce chapitre se consacre done a l'interface 
homme-machine (IHM) et aux processus de deploiement. 

Les employes de la societe gerent le catalogue des articles, les clients et 
affichent les bons de commande a l'aide d'une interface graphique de 
type client lourd (voir les cas d'utilisation « Gerer les clients », « Gerer le 
catalogue » et « Visualiser et supprimer les commandes »). Developpee 
en Swing, cette interface doit etre installee et executee sur le poste de 
chaque employe. 



Swing 



Approfondir Swing 



Le role de ce livre n'est pas de couvrir I'API Swing. 

Pour de plus amples informations, reportez-vous 

aux references suivantes : 

Creating a GUI with JFC/Swing (The Swing 

Tutorial) 

► http://java.sun.com/docs/books/tutorial/ 
uiswing 

Java CodeGuru: Swing 

► http://www.codeguru.com/java/Swing/ 
index.shtml 

DJ Kathy Walrath, Mary Campione, Alison 
Huml, Sharon Zakhour, The JFC Swing 
Tutorial: A Guide to Constructing GUIs, 
Second Edition, Addison-Wesley, 2004 
(D Emmanuel Puybaret, Swing, Eyrolles, 2006 
O Jean-Baptiste Briaud, Valerie Berthie, 
Swing - la synthese : developpement des 
interfaces graphiques en Java, Dunod, 
2005 



REMERCIEMENT L'application Swing Pet Store 

Je tiens a remercier David Dewalle pour m'avoir 
aide a developper l'application graphique de YAPS 
Pet Store. Celle-ci utilise entre autres le framework 
Open Source Greenauks dont David est le createur 
et qui simplifie le developpement MVC et la ges- 
tion des evenements Swing. 
► http://greenauks.v5projects.org/ 



La langage Java dispose de differentes API permettant de construire des 
interfaces graphiques sophistiquees telles que AWT et Swing. AWT est 
anterieure a Swing et fut developpee pour la premiere version du JDK 
(1.0) alors que Swing est apparue en tant que librairie annexe dans cette 
meme version mais ha ete integree dans le JDK qua partir de la 
version 1.2 (soit Java 2). II en resulte done des differences fondamentales 
de conception entre les deux librairies. 

Par exemple, un composant AWT est associe a une fenetre geree par le 
systeme d'exploitation sous-jacent, responsable de son apparence. Par 
opposition, les composants Swing sont simplement dessines a l'interieur 
de leur conteneur comme s'il s'agissait d'une image. Le systeme d'exploi- 
tation n'est pas sollicite mais uniquement la machine virtuelle Java. Avec 
Swing, les possibilites graphiques sont decuplees. On peut par exemple 
creer des boutons comportant une image a la place d'un texte, des bou- 
tons ronds, des bordures variees pour les composants, ou encore utiliser 
un composant d'arborescence (jTree). 

Ce chapitre ne couvre pas l'API Swing car elle est trop riche et ne cor- 
respond pas au theme principal de ce livre, qui n'est autre que Java EE. 
Swing n'est utilisee ici que comme support graphique pour appeler des 
EJB de maniere distante via JNDI. 

Exemple d'appel a un EJB dans Swing 

Dans la gestion du catalogue, les employes peuvent consulter le detail 
d'une categorie a partir d'un ecran Swing. Un extrait du code ci-apres 
nous montre les etapes necessaires a l'appel de la methode findCategory 
de l'EJB stateless CatalogBean. 
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Ecran d'affichage de la categorie 



public class CategoryCrudFrame extends Jlnternal Frame { 
(■ ■ ■) 

public void findActionPerformed(EventObject evt) { 

Context initalContext = new Initial Context 0 ; Q 
Catal ogRemote catalogRemote = (CatalogRemote) 

i ni tal Context .lookup("ejb/statel ess/Catalog") ; 0 

Category category = 

catal ogRemote. findCategory (identifier) ; Q 

model .setldentifier(category.getldO) ; 

model .setName(category.getNameO) ; Q 

model . setDescription(category.getDescription()) ; 

} 

} 

L'application distante a tout d'abord besoin d'obtenir le contexte initial 
JNDI O A partir de ce contexte, on recherche (lookup) l'EJB qui gere le 
catalogue et dont le nom est ejb/statel ess/Catalog Q. On obtient 
ainsi l'interface distante sur laquelle on appelle la methode metier du 
composant Q. La methode findCategory retourne un entity Category 
avec lequel on alimente les zones de l'ecran Q. Le resultat graphique est 
presente sur l'ecran ci-apres (figure 6-1). 



Rappel Le nom JNDI du CatalogBean 

Dans cet exemple, le nom du stateless session 
bean est ejb/statel ess/Catalog. Si vous 
vous reportez au code de l'EJB CatalogBean, 
vous verrez que ce nom est le meme que celui 
defini dans I'annotation OStatel ess. 
@Statel ess (mappedName= 

"ejb/statel ess/Catalog") 



4 (Read only) 



Category - 4 (Read only) 






Identifier 


4 


Name 


Cats 




Description 


Small carnivorous mammal domesticated since early times 
as a catcher of rats and mice and as a pet and existing in 





Find 



Create 



Update 



Delete 



Close 



Figure 6-1 

Affichage des informations d'une categorie 



JNDI 



Dans tout systeme distribue, le service de nommage est un service fonda- 
mental. II a pour vocation d'associer un nom a un objet et de permettre la 
recherche de cet objet a partir de son nom. Java Naming and Directory 
Interface (JNDI) fournit les fonctionnalites de nommage et d'annuaire 
aux applications ecrites en Java. JNDI est une abstraction d'annuaire et 
peut done etre utilise sur LDAP, NIS ou DNS par exemple. Ce service 



APPROFONDIR JNDI 



► http://java.sun.com/products/jndi/ 
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A LDAP, NIS et DNS 

• LDAP, ou Lightweight Directory Access 
Protocol, est un protocole qui permet 
d'acceder a des annuaires repondant a la 
norme x500. 

• NIS {Network Information Service) est le 
service qui permet a certaines informations 
d'etre connues par toutes les machines disponi- 
bles sur un reseau. 

• Un DNS (Domain Name System) est un ser- 
veur qui permet de faire correspondre une 
adresse web (URL) avec une adresse IP. 



Configuration jndi. properties 

Au lieu de coder en dur les parametres d'acces a 
JNDI, on peut les externaliser dans un fichier 
nomme jndi . properti es. Dans notre cas, 
nous allons deployer I'application sur le serveur 
GlassFish qui se trouve sur le meme serveur phy- 
sique (localhost) que I'interface cliente. Les para- 
metres par defaut du service JNDI n'ont done pas 
besoin d'etre modifies. Nous utiliserons le fichier 
jndi .properties inclus dans la distribution 
GlassFish. 



EJB cast ou narrow des interfaces ? 

Pour ceux d'entre vous habitues aux EJB 2.x, 
remarquez qu'en EJB 3 le resultat du lookup peut 
etre directement caste en interface remote sans 
avoir a utiliser la methode 
PortableRemoteObject . narrowQ. 



permet a un client de localiser un objet ou une ressource distribute. L'API 
JNDI est accessible a partir du paquetage javax . nami ng . *. 

Dans l'exemple precedent, pour pouvoir afficher une categorie, I'applica- 
tion Swing doit avant tout localiser I'interface CatalogRemote a partir 
d'un contexte initial. Dans ce type de systeme hierarchique, un contexte 
peut etre vu comme un noeud au sein d'un arbre. Le code Context 
initalContext = new Ini tial Context () permet d'obtenir la racine de 
cet arbre. Ensuite, charge a I'application de s'y deplacer pour obtenir 
l'objet quelle recherche. Par exemple le nom ejb/statel ess/Catalog 
signifie qua partir de la racine il existe un contexte appele ejb, puis un 
sous-contexte stateless dans lequel on trouve un objet nomme Catalog. 

Cependant, pour retrouver ces objets, I'application doit connaitre les 
parametres d'acces au service JNDI. Ces parametres sont propres a 
chaque serveur d'applications et peuvent, soit etre mis dans un fichier 
externe (jndi .properties), soit directement dans le code. 

Parametres d'acces au service JNDI de GlassFish 

! public class CategoryCrudFrame extends ^Internal Frame { 
C ■ ■) 

public void fi ndActionPerformed(EventObject evt) { 

Properties props = new PropertiesO ; Q 

props . set P rope rty("java. naming. factory. initial " , Q 

"com . sun . enterpr i se . nami ng . Seri al Ini tContextFactory") ; 
props. setProperty("java. naming. factory. url .pkgs", Q 

"com. sun. enterprise. naming") ; 
props . set P rope rty("java. naming. factory . state" , © 
"com . sun . corba . ee . impl . presentation . rmi . JNDIStateFactorylmpl ") ; 
props . set P rope rty("java. naming. provider .url " , "localhost") ; 

Context initalContext = new InitialContext(props) ; © 

CatalogRemote catalogRemote = (CatalogRemote) 

initalContext. lookup ("ejb/statel ess/Catalog") ; Q 

(...) 

} 

} 

Ce code cree un objet Properties Q dans lequel on affecte des valeurs 
specifiques © au serveur GlassFish afin d'acceder a son annuaire JNDI. 
Ces proprietes sont ensuite passees dans le constructeur du contexte ini- 
tial 0 et permettent de retrouver l'objet recherche ©. 
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Application Client Container 



Pour expliquer ['Application Client Container (ACC), il faut con- 
naTtre le mecanisme d'injection, ou pattern loC {Inversion of Con- 
trol). Si ce n'est pas le cas, reportez-vous au chapitre suivant, 
Interface web oil I'injection est expliquee en detail. 
Reprenons notre exemple : une classe a besoin de contacter un EJB. 
Pour cela, elle utilise JNDI pour obtenir une reference vers cet EJB. 
Lorsque cette classe est executee dans un conteneur (EJB ou web), le 
conteneur lui-meme injecte cette reference. Ce mecanisme permet a 
la classe de s'affranchir des appels JNDI. 

Depuis la premiere version de J2EE, il existe un conteneur web pour 
executer et gerer le cycle de vie des servlets, et un conteneur EJB pour 
faire de meme avec les Enterprise Java Beans. L' Application Client Con- 
tainer apporte les memes types de services, c'est-a-dire la securite, le 
service de nommage, I'injection, mais pour une application Java SE 
(Swing, dans notre exemple). Ainsi, en demarrant I'application a I'aide 
de la commande %GLASSFISH_HOME%/bi n/appcl i ent, nous 
aurions pu nous affranchir du Service Locator et beneficier de I'injection 
offerte par I'ACC. Le code est alors allege puisqu'il n'a plus besoin 
d'invoquer directement les classes de I'API JNDI. 
Voici a quoi ressemble I'appel d'une methode EJB lorsqu'on utilise 
I'Application Client Container : 



public class CategoryCrudFrame extends 
llnternal Frame { 
(...) 
@EJB O 

private CatalogRemote catalogRemote © 
(...) 

public void findActionPerformed(EventObject evt) { 
Category category = 

catalogRemote. findCategory(identifier) ; © 

model .setldentifier(category.getldO) ; 

model .setName(category.getNameO) ; 

model . setDescripti on (category. getDescripti on () ) ; 

} 

} 

Grace a I'annotation @EJB Q (detaillee dans le chapitre suivant), 
I'ACC injecte une reference de I'interface distante de I'EJB dans la 
variable catalogRemote©. Celle-ci peut ensuite etre utilisee 
directement © sans passer par des appels explicites a JNDI. 
Pour des raisons didactiques, j'ai prefere utiliser JNDI pour I'applica- 
tion cliente et I'injection pour les composants serveurs. 
► https://glassfish.dev.java.net/javaee5/docs/DG/beakt.html 



Comment developper Implication Swing 

Nous n'aborderons pas les API Swing de I'application, mais nous nous 
interesserons plutot a l'architecture utilisee pour decorreler la partie gra- 
phique des appels EJB. L'interface graphique utilisera done les deux 
design patterns Business Delegate et Service Locator pour separer la 
presentation de la logique de communication JNDI. 



Service Locator 

Comme nous l'avons vu precedemment dans le code, l'interface gra- 
phique a besoin de localiser les stateless beans au travers d'un service de 
nommage. Le code technique qui permet d'acceder a JNDI peut etre 
isole dans une meme et seule classe : le Service Locator. 

Le design pattern Service Locator, dont le seul but est de localiser des 
objets dans l'arbre JNDI, permet de rendre notre systeme plus flexible en 
centralisant et masquant les acces JNDI. En effet, au lieu d'ajouter ce code 
technique dans nos ecrans Swing, ce design pattern fournit plusieurs 
methodes pour retrouver des objets stockes dans le service de nommage. 



Approfondir Service Locator 



Core J2EE Patterns - Service Locator 
► java.sun.com/blueprints/corej2eepatterns/ 
Patterns/ServiceLocator.html 
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Contexte initial JNDI. 

Le cache est represents par une Map. 

Le design pattern Singleton utilise une methode 
statique pour acceder a I'unique instance de I'objet. 



Par exemple, l'extrait de code suivant decrit comment retrouver une 
interface distante. La methode getRemotelnterface prend en parametre 
le nom JNDI de la remote interface Q, effectue un lookup JNDI Q, 
puis retourne l'interface © si elle Fa trouve ou elle lance une exception 
de type ServiceLocatorException 0 dans le cas contraire. 

Extrait du code de la methode recuperant les interfaces distantes 

public Object getRemoteInterface(Stri ng jndiName) Q 

throws ServiceLocatorException { 

Object remotelnterface; 
try { 

remotelnterface = initalContext.lookup(jndiName) ; Q 
} catch (Exception e) { 

throw new ServiceLocatorException(e) ; Q 

} 

return remotelnterface; Q 

} 

L'autre avantage du Service Locator est d'optimiser la recuperation des 
objets en utilisant un mecanisme de cache. Lorsqu'il trouve un objet dans 
JNDI, le Service Locator le stocke dans un cache (une HashMap par 
exemple), puis le reutilise directement lors des appels suivants. Ceci n'est 
possible que si le Service Locator implemente le design pattern Singleton. 

Le singleton 

Un singleton est une classe pour laquelle une et une seule instance 
existe dans toute I'application. Toutes les references d'objets de ce type 
sont en realite des references a un meme objet. Par consequent, un sin- 
gleton n'est stocke qu'une seule fois en memoire. 
L'utilisation d'un singleton reside dans la prevention de la creation d'un 
objet autre que celui que vous fournissez. Pour ce faire, il suffit dans un 
premier temps de declarer tous les constructeurs comme etant prives, et 
d'avoir une methode publique et statique permettant de retourner I'ins- 
tance unique du singleton. 
► http://c2.com/cgi/wiki7SingletonPattern 

Le code suivant vous montre le Service Locator implemente en singleton 
et utilisant un systeme de cache (private Map<String, Object> cache). 

Service Locator avec cache et singleton 

public class ServiceLocator { 

► private Context inital Context; 

► private Map<String, Object> cache; 

► private static ServiceLocator instance= new ServiceLocatorQ ; 
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public static Servi ceLocator getlnstanceO { 
return instance; 

} 

private Servi cel_ocator() throws ServiceLocatorException { 
try { 

inital Context = new Ini tial Context () ; 
cache = new HashMap<Stri ng , Object>(); 
} catch (Exception e) { 

throw new Servi ceLocatorException(e) ; 

} 

} 

public Object getRemoteInterface(Stri ng jndiName) 

throws ServiceLocatorException { 

Object remotelnterface = cache. get (jndi Name) ; 

if (remotelnterface == null) { 
try { 

remotelnterface = i nital Context. lookup(jndi Name) ; 
cache. put (jndi Name, remotelnterface) ; 
} catch (Exception e) { 

throw new ServiceLocatorException(e) ; 

} 

} 

return remotelnterface; 



Le constructeur est prive, il ne peut done pas 
etre appele par une classe exterieure, ce qui 
nous garantit I'unicite de I'instanciation. On ini- 
tialise le contexte JNDI et le cache dans le cons- 
tructeur. 



Methode permettant de retrouver une interface 
distante. 



On commence par rechercher I'objet dans le 
cache. 



Si I'objet ne s'y trouve pas, on le recherche dans 
JNDI puis on le stocke dans le cache pour les uti- 
lisations futures. 



Business Delegate 

Nous venons d'isoler le code JNDI dans un Service Locator, il ne nous 
reste plus qua deleguer son appel par un Business Delegate. L'idee de ce 
pattern est d'avoir une classe Business Delegate par stateless session 
bean qui redefinit chaque methode distante. Les interfaces graphiques 
n'utilisent done que les methodes des objets Delegate sans se preoccuper 
de la facon de recuperer la reference sur l'interface distante. Ce design 
pattern permet de regrouper a un seul endroit tous les appels distants. 

Nous disposerons done de trois classes, nominees CatalogDelegate, 
CustomerDelegate et OrderDel egate, et qui respectivement delegueront 
les appels aux interfaces CatalogRemote, CustomerRemote et OrderRemote. 
Par exemple, l'extrait de code ci-apres represente la classe 
CustomerDelegate qui delegue les appels a l'EJB CustomerBean. 

Extrait de la classe CustomerDelegate 

public final class CustomerDelegate { 

(...) 

Cette methode statique appelle la methode 
f i ndCustomer de l'EJB CustomerBean. 



public static Customer fi ndCustomer (Long customerld) { < 
return getCustomerRemoteQ . fi ndCustomer (customerld) ; 
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Celle-ci delegue I'appel a deleteCustomer. 



Cette methode privee appelle le Service Locator 

pour obtenir I'interface distante. 

Notez le nom JNDI de I'EJB. Celui-ci est defini 

dans I'annotation ©Stateless de 

CustomerBean. 



ifondir Business delegate 



Core J2EE Patterns - Business Delegate 

► http://java.sun.com/blueprints/ 
corej2eepatterns/Patterns/ 
BusinessDelegate.html 

Business Delegate 

► http://c2.com/cgi/wiki7BusinessDelegate 



public static void del eteCustomer (Customer customer) { 
getCustomerRemoteO . del eteCustomer (customer) ; 

} 

private static CustomerRemote getCustomerRemoteO { 
CustomerRemote CustomerRemote ; 
customerRemote = (CustomerRemote) 
ServiceLocator . getlnstance() . getRemoteInterface( 

"ejb/statel ess/Customer") ; 

return customerRemote; 

} 

} 

Vbus retrouverez ci-apres l'extrait de code initial permettant d'afficher 
une categorie, en utilisant dorenavant la classe CatalogDelegate. 

Ecran d'affichage de la categorie avec Business Delegate 

public class CategoryCrudFrame extends JInternal Frame { 
(...) 

public void findActionPerformed(EventObject evt) { 

Category category= CatalogDelegate. findCategory(identifier) ; 

model .setldentifier(category.getldO) ; 

model .setName(category.getName()) ; 

model . setDescri pti on (category . getDescri ption()) ; 

} 

} 



UML Diagramme de sequences 

Le diagramme de sequences permet de representor 
des collaborations entre objets selon un point de 
vue temporel. On y met I'accent sur la chronologie 
des envois de messages. Les diagrammes de 
classes montrent la composition statique des 
classes, alors que le diagramme de sequences se 
penche sur la dynamique de leurs collaborations. 

Rappel Interface locale des EJB 

L'application graphique ne peut pas utiliser I'inter- 
face locale de I'EJB car elle se trouve en dehors du 
conteneur. Elle ne peut utiliser que la Remote. 



Appel d'un EJB stateless dans cette architecture 

Voyons maintenant comment tout cela s'imbrique a l'aide d'un dia- 
gramme de sequences. Dans ce genre de diagramme, les objets commu- 
niquent en invoquant des operations sur d'autres objets. On peut done 
suivre visuellement les differentes interactions et les traitements realises 
par chaque objet. Prenons pour exemple la recherche d'un client et l'affi- 
chage de ses informations. Le diagramme de sequences (figure 6-2) 
nous montre comment l'ecran Swing invoque I'EJB au travers de la 
classe CustomerDelegate. 

L'application Swing appelle la methode findCustomer Q de la classe 
CustomerDelegate. Celle-ci doit retrouver I'interface distante de I'EJB 
grace au singleton ServiceLocator. Elle appelle done la methode 
getlnstance © puis getRemotelnterface © en passant le nom JNDI de 
I'EJB (e'est-a-dire ejb/stateless/Customer). La classe CustomerDelegate 
utilise I'interface CustomerRemote et appelle la methode findCustomer Q 
ce qui a pour effet d'appeler la classe d'implementation CustomerBean Q. 
C'est cette derniere qui manipulera l'entity manager 0 pour obtenir 
l'entity Customer. L'application Swing se retrouve done avec un objet 
Customer sur lequel elle peut invoquer les getters (© et ©) pour afficher 
les informations a l'ecran (figure 6-3). 
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Figure 6-2 Diagramme de sequences pour afficher les donnees d'un client 



Bo 



Customer - 4 (Read only) 



First Name Antonio 

Last Name Goncalves 

Date of birth 29/05/1971 

Age 35 

Telephone 487 487 21 

Email antonio.goncalves@gmail.com 



Lorjin antoncal 
Password 



Address 



Street 1 42 Glass Street 
Street 2 

City Oakland 
State 



LA 

Zipcode 8765 
Country USA 



Find 



Create 



Figure 6-3 

Ecran d'affichage des donnees d'un client 
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Remarque Look & Feel Swing 

Swing peut prendre differents aspects graphiques : 
Windows, Metal ou Motif dans notre exemple, 
mais il en existe bien d'autres selon la plate-forme 
et les licences. 

► http://www.javootoo.com/ 



Comme nous l'avons vu precedemment, les entities peuvent se detacher 
de l'entity manager et devenir de simples Pojo sans persistance. C'est ce 
qui se passe lorsque l'ecran Swing manipule l'objet Customer pour en 
afficher les donnees. Par contre, pour pouvoir traverser le reseau, cette 
classe doit implementer l'interface Sen'alizable. 

L'avantage de ce decoupage en couche reside dans le fait que implica- 
tion cliente ne connait pas la logique metier qui se cache derriere la 
recherche d'un client. Elle passe juste un identifiant a une methode qui 
lui retourne l'objet initialise avec les donnees de la base. Les patterns 
Business Delegate et Service Locator nous aident d'autant mieux a faire 
ce decoupage qu'ils isolent les responsabilites de chaque classe. 

[.'application graphique YAPS Pet Store 

L'interface graphique des employes de la societe YAPS se compose d'un 
menu principal (figure 6-4) qui permet d'acceder a differents sous-menus 
(tableau 6-1). Chacun d'eux correspond a une des fonctionnalites presentees 
dans les cas d'utilisation. 



Figure 6-4 

Menu principal 



t Pet Store 



File Customer Catalog Order Look&Feel 



Tableau 6-1 Sous-menus de I'application 



File 


Exit 


Permet a I'employe de fermer I'application 


Customer 


List customers 


Affiche la totalite des clients de la base de donnees 




Manage customer 


Effectue les operations CRUD sur un client 


Catalog 


List categories 


Affiche la totalite des categories du catalogue 




List products 


Affiche la totalite des produits du catalogue 




List items 


Affiche la totalite des articles du catalogue 




Manage category 


Effectue les operations CRUD sur une categorie 




Manage product 


Effectue les operations CRUD sur un produit 




Manage item 


Effectue les operations CRUD sur un article 


Order 


List orders 


Affiche les bons de commande 




Manage order 


Affiche l'ecran permettant a I'employe de retrouver et de supprimer une commande 




Watch orders 


Affiche en temps reel les commandes contenant des reptiles 


Look&Feel 


Metal 


Change I'aspect de I'application en Metal 




Motif 


Change I'aspect de I'application en Motif 




Windows 


Change I'aspect de I'application en Windows 
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Ces menus affichent principalement deux types d'ecrans : £ 

• les listes permettant aux employes de consulter la totalite des ele- "| 
ments du systeme ; 1 

• les ecrans de creation, de mise a jour, de recherche et de suppression & 
ne manipulant qu'un seul element a la fois. * 



La gestion des clients 

Les employes peuvent consulter la liste des clients en cliquant sur le menu 
Li st customers. Cette liste comporte un bandeau de boutons permettant 
une action sur le client selectionne. Ainsi, en cliquant sur une ligne de la 
liste, puis sur le bouton Vi ew, un nouvel ecran s'affiche contenant les infor- 
mations du client. Appuyez sur Create et un ecran vierge s'affichera vous 
demandant de saisir les coordonnees d'un nouveau client, etc. (figure 6-5). 



I File Customer Catalog Order Look&Feel 
L~] Custuniei (Ciedle) 



Dale of bin- 
Age 



Login 
Passwor 
Address 
Street 1 
Street 2 
fjy 



Customer (Create) 



1 (Read only) 



Customer - 3 (Read only) 



3 

Steve 



Ddleufliiilh 30/11/1964 
Age 



41 

548167 15 

steve-jobs@apple.com 



Ideiitiliudliun 
Louki jutj 



Address 

Street 1 154 Star Boulevard 
Street 2 



San Francioco 



: Lists all the customers 



a a* C 



ID 


Fir?! Name 


Last Name 


Telephone 


Email 


City 


Country 


1 


Marc 


Fleuiv 


545123 45 


marc^lboss org 


LOSAnge 


USA 


2 


Bill 


Gdles 


554 046 12 


bill ualesiSKiiicius 


Allldbdllld 


USA 




4 


Antonio 


Conceives 


407 407 21 antonio goncatos 


Oakland 


U0A 



Customer • 3 (Delete) 



□ Custunu ■ 3 (Uuuale) 



Customer - 3 (Update) 



Identifier 
Fiist Name 



[lobs 



oofbirth j 30/11/1 064 



l steve.ioBSBappie.com 



Identification 
Login [ job 



Street 1 1 54 Ctar Coulevard 
Street 2 
City 

State tv: 
Zilitutle 1 5455 



Ran Franrisrn 



Country |U0A 



Figure 6-5 Actions possibles sur le client 
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Figure 6-6 

Delegate et interface distante 



Chacune de ces actions (un clic sur un bouton) appelle une methode de 
la classe CustomerDelegate en passant les parametres attendus. Ci-apres 
un diagramme de classes montrant la reciprocity entre le Delegate et 
l'interface de l'EJB (figure 6-6). 



+createCustomeri:customer : Customer, address : Address) : Customer 



«Delegate» 
CustomerDelegate 



+findC ustomen: custom erl d : Long): Customer 
+deleteCustomei( customer : Customer) : void 

+updateCustomer(customer : Customer, address : Address) : Customer 



fJeleciue 



—> 



«interface» 
Customerft emote 


-createC ustom er(customer 


Customer, homeAddress 


Address) 


Custom er 


-1indCustomer(customerld : 


Long): Customer 






-d eleteC ustom erfcustom er 


Customer) : void 






-updateC ustom er(custom er 


: Customer, homeAddress 


: Address) 


: C ustom er 



Remarque Le code des Delegate 

Le code des Delegate est assez simple et repetitif. 
Pour des raisons de clarte, le code ainsi que les 
diagrammes de classes des Catal ogDel egate 
et OrderDel egate ne seront pas detailles. 



Affichage des erreurs 



La gestion du catalogue 

Les ecrans de la gestion du catalogue ressemblent a ceux du client. Une 
particularite, tout de meme, est a noter : l'utilisation des combobox pour 
les relations l:n. En effet, un produit etant rattache a une categorie, on 
retrouve une liste de categories dans l'ecran du produit. De meme pour 
les articles et les produits (figure 6-8). 



Lors de la creation d'une categorie, le nom ainsi que la descrip- 
tion sont obligatoires. La validation de ces informations est faite 
par I'entity Category avant qu'il ne persiste ses donnees (c'est-a- 
dire dans une methode annotee par OPrePersi st). 
@PrePersist 
@PreUpdate 

private void validateData() { 

if (name == null || "".equals(name)) 

throw new Val idationExcepti on ("Invalid name"); 
if (description == null || "".equals(description)) 

throw new Val idationExcepti on ("Invalid description"); 

} 

Si Ton essaie de creer une categorie sans nom, I'entity lance une 
exception de type Val idationExcepti on, qui est attrapee puis 
affichee par le client Swing. 



Hie customer catalog uraer Look&Ueel 



III ClK/llK) 



° 



rv m 



Category (Find or Create' 



***** 



una | create | uiiitai 



A 



Figure 6-7 Affichage des exceptions 



La gestion des bons de commande 

Les bons de commande ne peuvent pas etre crees ou modifies par 
l'application Swing. Les employes ne peuvent qu'en obtenir la liste, en 
consulter le detail et eventuellement, en supprimer un (figure 6-9). 
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Tile Customer Cataloo Order Look&reel 
□ Lias ai 



a'a" S 



ID 


Nome 


Description 


i 


Biros 


Any or me class Aves otwarm-oioooed, egg-laying, learner.-. 


4 


cats 


Bmall carnivorous mammal domesticated since early tim .. 




Dogs 


A [IcimCGlicoIccI criitifvijiuu:: m^rnrnri to rile a tc the la.ee. ri 


3 


NuClHC'G 


A-Tv nr ...otluL,::; cold |i 0 0 "Jo (1 LJOUril'v :i;t(| |r.\ 1." i| VC ttl'l: IOtC 0 





□ Lists all the products 



-' a" ]£ | 



ID 

15 


Name 
Amazon Parrot 


Description 
Great companion for up to 75 years 


Category. 
Biros 




1 




Saltwater dsn from Australia 


Fish 




5 


Bulldog 


F'Iqii :ll"c:o:i 


rom England 


Dcqe 




10 


: n hush us 


treat c urn pa 


|jr 30 q 


DC qe 
















Find 


Create 


View 


Update Delete 


Close 





Product - 7 (Update) 



Catwyuiy 





Great dog ror a tire station 


Dogs 




Birds 




cats 






IWi 




Reptiles 





t2 

IB 



B lists 



o'ur" H 



ID 


N=irrie 


Unil Cuvl 


Piuduil Nam* 




-;v 


Femate Adult 




Fintti 




3ft 


Femalfl Arlult 










FntfinlH Ailult 




Manx 






Ft-rr hIh Ail ill 


i ■in r 






71 


FhitihIh Ailult 


?nn 


RHlllHSriHkH 






Figure 6-8 

Gestion du catalogue 
utilisant des combobox 



Me customer catalog untcr Look&rcel 



C 



Order - 1 (Read only) 



O Lists ail the orders 



llD 


Date^^^^ 


Customer Name 


Number of A - 


Total 




31/IL/2006 


FleuryMarc 


: 


060 


3 


28/08/2006 


Gates Bill 


3 


3<2 0 



n'V H 




Figure 6-9 

Affiche les bons de commande 
et leur detail. 
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Figure 6-10 Classes Swing, 
Delegate et Locator 



Paquetages du client Swing 

Les classes de l'application graphique sont placees dans le paquetage 
com . yaps . petstore . cl i ent. Les classes Swing sont dans le sous-paquetage 
ui , les Business Delegate dans del egate et le Service Locator dans 1 ocator. 



Architecture 

Larchitecture globale de l'application est maintenant constituee de trois 
couches principales : l'interface graphique, la couche de traitements et 
les objets persistants. Les ecrans Swing utilisent les Delegate et le Servi- 
ceLocator pour acceder aux interfaces distantes des stateless beans. Ces 
derniers manipulent les entities a l'aide de l'entity manager. 




Arborescence des repertoires 

Les classes java sont developpees dans le reper- 
toire src, compilees dans classes et packa- 
gees dans build. 

& Yaps 

- m build 

- classes 
U- Bsrc 

rk- EE' com 
kt- EE yaps 

£h EE- petstore 
+ client 
§□ entity 
-■ exception 



loolup JNDI 

Figure 6-11 Architecture de l'application avec l'interface graphique 

Notez la relation : une classe Delegate pour une interface distante d'un 
EJB. Les interfaces locales seront utilisees par l'application web dans le 
prochain chapitre. 



Executer l'application 



Figure 6-12 Repertoires de l'application 



Maintenant que nous avons etudie les ecrans Swing et leur imbrication 
dans l'architecture, il ne nous reste qua executer l'application. Pour cela, 
il faut d'abord compiler les classes developpees jusqu'ici, les packager 
dans des fichiers .jar, puis les deployer sur le serveur GlassFish. Les 
taches Ant s'occuperont d'effectuer tous ces traitements. 
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Compiler 



Avant tout, il faut compiler les classes qui se trouvent dans le repertoire 
src. La tache Ant yaps-compi 1 e se charge de les compiler et de les placer 
dans le repertoire classes (figure 6-13). Si Ton souhaite supprimer tous 
les fichiers . cl ass et les repertoires de travail (bui 1 d et cl asses), il suffit 
d'utiliser la tache Ant yaps-cl ean. 



Ant Les taches dans build. xml 
et admin. xml 

Les fichiers contenant les taches Ant 
(bui Id. xml et admin. xml) sont decrits en 
annexe et telechargeables sur : 
► http://www.antoniogoncalves.org 



.□X 



:\YapsPet store >ant yaps-compile 
uildf ile : build. xml 

yaps -pre pare : 

[echo] Setup the Vaps environment 
[mkdir ] Created dir : E:\VapsPetstoreSyapsSbuildSlib 

yaps -compile : 

[echo] Compile the classes 
[ jauac ] Compiling 88 source files to E:\VapsPetstoreSyapsSclassesSproduction 



Figure 6-13 

Execution de la tache yaps-compile 



Pour pouvoir compiler, notre application requiert 1'utilisation de cer- 
taines librairies du serveur GlassFish (toutes les classes et annotations de 
Java EE 5 importees dans notre code). La tache Ant se charge de 
raj outer ces librairies externes dans le classpath. Vous retrouverez la liste 
de ces librairies en annexes dans le fichier build. xml . 



//, La variable classpath 



La variable classpath definit les repertoires oil 
doit etre recherche le byte-code et/ou les sources des 
classes Java lors de la compilation et de I'execution. 



Packager 

Une fois les classes compilees, il est necessaire de les packager dans des 
fichiers d'archive. Ces archives constituent le moyen standard d'empaqueter 
toutes les parties de l'application (bytecode Java, images, fichiers de pro- 
prietes, etc.) afin d'etre executees ou deployees. On execute la tache yaps- 
build pour creer les fichiers d'archive de iinterface graphique et de l'applica- 
tion serveur (figure 6-14). Ces fichiers sont places dans le repertoire bui 1 d. 



Figure 6-14 

Execution de la tache yaps-build 
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E:\VapsPetstore>ant yaps-build 
Buildfile: build. xml 

yaps -bui ld-client- jar : 

[echo] Creates the Client jar 
[jar] Building jar: E:S¥apsPetstore\yaps\build\petstore -jar 

yaps -build-state less- jar : 

[echo] Creates the EJB Stateless jar 
[jar] Building jar: E:SVapsPetstore\yapsSbuildSstate less .jar 

yaps -bu i Id-en t it y- jar : 

[echo] Creates the EJB Entity jar 
[jar] Building jar: E:\VapsPetstoreSyapsSbuildMibSentity . jar 

yaps -bui ld-utility- jar : 

[echo] Creates the Utility jar 
[jar] Building jar: E:\VapsPetstoreSyaps\build\lib\utility.jar 

yaps -build-ear: 

[echo] Creates the PetStore Enterprise Application 
[jar] Building jar: E:\VapsPetstoreSyapsSbuildSpetstore .ear 

yaps-build : 

BUILD SUCCESSFUL 



da- &com 

& yaps 

& petstore 
CD client 
CD entity 
CD exception 
stateless 
CD catalog 
CD customer 
CD order 
fe- & META-INF 

L H MANIFEST. MF 

Figure 6-15 Contenu du fichier petstore.jar 

A Le fichier MANIFEST.MF 

Dans I'arborescence graphique du fichier 
petstore.jar, vous voyez apparaTtre un 
fichier MANIFEST.MF. Celui-ci est indispensable 
aux fichiers d'archive. Present dans le repertoire 
META-INF, il peut contenir de nombreuses infor- 
mations (sous la forme cle/valeur) sur I'archive et 
son contenu. 



Cl petstore. ear 
k- &lib 

I- 9 utility.jar 
L ^enlily.jar 

L C§ persistence.xml 
- ^ stale less.jar 

Figure 6-16 Contenu du fichier petstore.ear 

//, Les fichiers d'archive 

II existe plusieurs types de fichiers d'archive pour 
packager une application Java EE : 

• les . jar (java archive) pour les classes Java et 
les EJB ; 

• les .war (web archive) pour les applications 
web (servlet, jsp, jsf, images, html, etc.) ; 

• les . ear (enterprise archive) pour contenir les 
fichiers .jar et .war. 



Annotations Les descripteurs XML 

Lorsqu'on deployait des EJB en J2EE 1.4, il fallait 
fournir des descripteurs de deploiement XML 
(ejb-jar.xml et application.xml). Les 
annotations de Java EE 5 nous permettent de nous 
affranchir de ces fichiers devenus optionnels. 



Interface graphique 

La totalite de l'application graphique est contenue dans le fichier 
petstore.jar. II y a, bien sur, toutes les classes Swing du paquetage 
com . yaps . petstore . cl i ent . ui , mais aussi les Business Delegate et le Ser- 
vice Locator. Pour pouvoir manipuler les entities, il faut les rajouter dans 
ce .jar ainsi que les exceptions et les interfaces distantes des EJB stateless 
(c'est-a-dire CatalogRemote, CustomerRemote et OrderRemote). Le fichier 
petstore . jar ne requiert ni les interfaces locales (car uniquement accessi- 
bles a l'interieur du conteneur), ni les classes d'implementation des EJB 
stateless. 

Application serveur 

Cote serveur, l'application est packagee dans un fichier .ear. Ce type 
particulier d'archive est utilise pour les applications d'entreprise (enter- 
prise archive) et contient plusieurs autres fichiers. Sa structure est repre- 
sentee graphiquement ci-apres. 

Les classes et interfaces des EJB session (Remote, Local et Bean) se trou- 
vent dans le fichier stateless. jar, les entities dans entity. jar et les 
exceptions, et autres classes utilitaires, dans utility.jar. 

Remarquez la disposition de ces fichiers a l'interieur de TEAR, 
stateless, jar est place a la racine, alors que entity, jar et utility.jar 
sont dans le sous-repertoire lib. Ce repertoire est particulier puisqu'il 
permet de partager les classes a tout le fichier .ear. En effet, comme nous le 
verrons par la suite, les EJB stateful et asynchrones auront, eux aussi, besoin 
des entities et des exceptions. Pour ne pas dupliquer ces classes dans les dif- 
ferents fichiers .jar, on les rend accessible en les placant dans le repertoire 
lib. 

Derniere particularite, le fichier persistence.xml se trouve dans le reper- 
toire META-INF du fichier entity, jar. Ce fichier doit etre deploye dans ce 
repertoire pour etre pris en compte. Rappelez-vous que ce fichier permet 
d'informer le conteneur de l'unite de persistance qu'il doit utiliser. 

Deployer 

Le deploiement n'est pas necessaire pour la partie graphique qui est con- 
sideree comme une simple application Java SE. Par contre, il est indis- 
pensable pour la partie serveur puisque les EJB doivent s'executer a 
l'interieur d'un conteneur. 
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Avant toute chose, le serveur GlassFish et la base de donnees Derby doi- 
vent etre demarres. Pour cela, utilisez les taches Ant d'administration : 



%PETST0RE_H0ME%\> ant 
%PETST0RE_H0ME%\> ant 



-f admin. xml start-domain 
-f admin. xml start-db 



Pour verifier que GlassFish fonctionne, rendez-vous a l'adresse http:// 
local host: 8080. La page d'invite s'affiche. Vous pouvez aussi consulter 
les logs et verifier que le message suivant apparait : 

| Application server startup complete. 



GlassFish Consulter les logs 

Pour lire les logs du serveur GlassFish vous pouvez, soit consulter le fichier 
%CLASSFISH_HOME%\domains\petstore\logs, soit vous connecter a la console 
d'administration. Pour cela, allez a l'adresse http: //local host : 8282 puis saisissez 
le nom de I'utilisateur admin et son mot de passe adminpwd. Cliquez sur le menu 
Application Server > View Log Files. 



Ce n'est qu'une fois le serveur demarre que Ton peut deployer l'applica- 
tion. Pour cela, utilisez la tache Ant yaps-deploy (figure 6-17). Celle-ci 
fait appel au programme d'administration de GlassFish (asadmi n) et lui 
passe en parametre le fichier petstore.ear. 



//. Java Web Start 



Nous aurions pu deployer le client Swing avec Java 
Web Start. Cette technologie, developpee avec la 
plate-forme Java 2 et incluse dans le JRE depuis la 
version 1 .4, permet le deploiement d'applications 
Java SE a travers le reseau. On peut ainsi installer 
une application grace a un simple die dans un 
navigateur. Java Web Start assure alors la mise a 
jour automatique des nouvelles versions de I'appli- 
cation et utilise un cache local pour accelerer sa 
reutilisation ulterieure. 

► http://java.sun.com/products/javawebstart/ 



Ant Deploy, undeploy 

Une fois I'application deployee a I'aide de la tache 
yaps-deploy, on peut la supprimer du serveur 
GlassFish en utilisant la tache yaps-undepl oy. 



Open JEE5 



~^:\YapsPetstore>ant yaps-deploy 
uildf ile : build .xml 



aps -deploy : 
[echo ] 



[echo] Deploys the VAPS application 
[exec] Command deploy executed successfully 



lb- insert -data: 

[sql] Executing resource : E:\VapsPetstore\yapsSconf igSdata.sql 
[sql] 91 of 91 SQL statements executed successfully 



] 



Figure 6-17 Execution de la tache yaps-deploy 



Le deploiement permet au serveur d'applications de lire le fichier . ear et 
d'en extraire les informations utiles. Ce processus va done creer la base 
de donnees a partir des annotations JPA, decouvrir les EJB grace aux 
annotations @javax.ejb. Stateless, acceder au service de nommage 
pour y stocker les interfaces distantes, etc. Chacune de ces etapes affi- 
chera des traces dans GlassFish. 

Top Link va done creer les differentes tables et colonnes a partir des enti- 
ties et tracera ces actions dans son fichier de logs. 
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Creation automatique des tables 

Le schema de la base de donnees peut etre automatiquement cree 
lors du deploiement des entities. Cette information est contenue 
dans le fichier persi stence.xml (package dans entity .jar) 
et peut etre modifiee. 
<persistence> 
<persi stence-uni t name="petstorePU"> 
<j ta-data-sou rce>jdbc/ petstoreDS</j ta-data-sou rce> 
<properties> 
<property name="topl ink. target-database" 

value="Derby"/> 
<property name="topl i nk. ddl -generati on" 

va"lue="drop-and-create-tables"/> Q 
<property name="topl i nk. create-ddl - jdbc-f i 1 e-name" 

value="create.sql"/> Q 
<property name="topl i nk . d rop-ddl -jdbc-f i 1 e-name" 

va"lue="drop.sqV'/> Q 
<property name="topl i nk . 1 oggi ng . 1 evel " 
value="FINEST"/> Q 
</properties> 
</persi stence-uni t> 
</persistence> 



L'attribut topi ink. ddl -generation Q permet a TopLink de 
savoir quelle action entreprendre lors du deploiement. II accepte les 
valeurs suivantes : 

• drop-and-create-tables : lors du deploiement, le schema 
de la base de donnees est supprime puis recree. 

• create-tables : a chaque deploiement, TopLink execute les 
requetes de creation des tables, meme si elles existent deja. Des 
avertissement peuvent alors apparaTtre. 

• none : TopLink n'entreprend aucune action, a vous de garantir 
I'existence des tables. 

Les autres proprietes de ce fichier signifient que les scripts SQL de 
creation et de suppression generes par TopLink se trouvent dans les 
fichiers create. sql Q et drop.sql Q. Pour augmenter ou 
diminuer le niveau de traces, on peut modifier le parametre 
toplink. logging. level Q. 

Notez que tous ces parametres sont propres a TopLink qui est le 
moteur de persistance de GlassFish. Une autre implementation de 
JPA, comme Hibernate par exemple, utilisera d'autres proprietes. 
► http://www.oracle.com/technology/products/ias/toplink/jpa/ 
resources/toplink-jpa-extensions.html#Java2DBSchemaGen 



Traces de creation du schema de la base de donnees 

The alias name for the entity class [class 

com. yaps. petstore. entity. catalog. Product] is being defaulted 
to: Product. 

The column name for element [private java. 1 ang . Long 

com. yaps. petstore. entity. catalog. Product. id] is being defaulted 

to: ID. 

The column name for element [private java. 1 ang . Stri ng 
com. yaps. petstore. entity. catalog. Product. name] is being 
defaulted to: NAME. 

The column name for element [private java. lang. String 

com. yaps. petstore. entity. catalog. Product. description] is being 

defaulted to: DESCRIPTION. 

Notez que suite au deploiement, la tache Ant yaps-deploy en profite 
pour inserer des donnees dans la base via la tache db-i nsert-data (qui se 
trouve dans le fichier build.xml). Celle-ci execute le fichier data.sql 
contenant les ordres SQL i nsert et permet ainsi d'avoir un jeu de don- 
nees initial pour utiliser l'application (voir annexe B). 

En ce qui concerne nos trois stateless session beans, ils sont enregistres 
dans JNDI et deviennent accessibles de maniere distante : 
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Traces d'un enregistrement des interfaces dans JNDI fait au deploiement 



java: comp/env/ 

com . yaps . pets to re . statel ess . custome r . Customer Bean/ 
em; | naming. bind 

RemoteBusiness Jndi Name: ej b/statel ess/Customer ; remoteBusIntf : 
com . yaps . pets to re . statel ess . custome r . Customer Remote 

j ava : comp/env/com . yaps . pets to re . statel es s . catal og . Catal ogBean/ 
em; | naming. bind 

RemoteBusi nessJndi Name : ejb/statel ess/Catalog; remoteBusIntf: 
com . yaps . pets to re . statel ess . catal og . Catal ogRemote 

java: comp/env/com. yaps . pets to re. stateless .order .OrderBean/ 
em; | naming. bind 

RemoteBusi nessJndi Name: ej b/statel ess/Order ; remoteBusIntf: 
com . yaps . pets to re . statel ess .order . OrderRemote 

Une fois le fichier petstore . ear deploye et toutes ces etapes passees avec 
succes, vous pouvez vous rendre sur la console d'administration de 
GlassFish pour consulter ces informations (http: //local host: 8282). 
Vous trouverez, entre autres, le contenu de l'arbre JNDI avec tous les 
stateless beans deployes (figure 6-18). 



<3 http://localhost:8282 - Jndi Tree Br 



Mozilla Firefox 



Jndi Tree Browsing | Refresh || Close | 

View JNDI names. The resource object and its JNDI name are bound together- 



CD ejb 

v stateless 
Q Order 

Q Catalog#com.yaps. petstore. stateless. catalog.CatalogRemote 

Q Catalog 3_x_lnternal_RemoteBusinessHome 

Q Catalog 

Q Customer 3_x_lnternal_RemoteBusinessHome 

Q Customer 

Q Order 3_x_lnternal_RemoteBusinessHome 

Q CustomerScom yaps petstore stateless customer.CustomerRemote 
Q Orderfr-com yaps petstore stateless order OrderRemote 




Figure 6-18 

Stateless beans dans JNDI 



Executer 

Toutes nos classes sont compilees, packagees et deployees sur le serveur 
d'applications. La base de donnees est creee et contient des donnees. II 
ne reste plus qua executer l'interface graphique pour effectuer les traite- 
ments metier demandes par les employes de la societe YAPS. Pour ce 
faire, utilisez la tache Ant run-client (figure 6-19). 



Open JEE5 - ant run-client 



E:\YapsPetstore>ant run-client 
Buildf ile : build. xml 

run -client : 

[echo] Runs the client application 



Figure 6-19 

Execution de la tache run-client 



Figure 6-20 

Menu principal de I'application cliente 



Cette tache lance la classe du menu principal (PetstoreFrame) qui se 
trouve dans le fichier d'archive petstore. jar. Pour pouvoir s'executer 
convenablement, certaines librairies GlassFish sont rajoutees au class- 
path. II ne vous reste plus maintenant qua utiliser I'application Swing 
(figure 6-20) avant de passer a l'interface web. 
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En resume 

Ce chapitre nous a montre comment compiler, packager et deployer 
I'application YAPS Pet Store dans le serveur GlassFish. Une interface 
graphique Swing a egalement ete developpee pour permettre aux 
employes de gerer le catalogue, les clients et les bons de commande du 
systeme. II nous faut maintenant developper une interface web pour per- 
mettre aux internautes de consulter le catalogue d'articles et de se creer 
un compte. Ces deux IHM deleguent les traitements metier a la couche 
de stateless session beans que nous avons vu dans le precedent chapitre. 
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chapitre 





Interface web 



L'application est a present deployee et utilisable par 

un client Swing. II nous faut maintenant developper l'interface 

web qui sera utilisee par les internautes et clients de la societe 

YAPS. Ce chapitre introduit les technologies servlet, JSP 

et JSTL avant de presenter JSF et son modele MVC. 

L'application web utilise JSF et dialogue avec la couche 

de stateless beans. 



SOMMAIRE 

► Interface web de l'application 

► Visualiser le catalogue 

► Rechercher les articles 

► Gerer le compte client 

► Le duo servlet-JSP 

► JSF et le modele MVC 

► Appel local des stateless bean 

► L'injection 

► Navigation entre pages 

MOTS-CLES 

► Servlet 
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► JSTL 
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► ELetUEL 
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Approfondir html & css 



► http://www.w3.org/MarkUp/ 

► http://www.htmlprimer.com/ 

► http://www.w3.org/Style/CSS/ 

► http://www.w3schools.com/css/ 

CO Eric Sarrion, Introduction a HTML et CSS, 
O'Reilly, 2006 



Les employes ont leur application, il est temps maintenant de deve- 
lopper la partie web pour les internautes et les clients. Elle leur per- 
mettra de consulter le catalogue, de rechercher des articles par mots-cles 
mais aussi de se creer un compte et de devenir client (voir cas d'utilisa- 
tion « Visualiser les articles du catalogue », « Rechercher un article », 
« Se creer un compte », « Se connecter et se deconnecter », « Consulter 
et modifier son compte »). 



A CGI, ASP et PHP 



CGI [Common Gateway Interface), invente en 
1993, permet d'executer un programme sur un ser- 
veur et de renvoyer le resultat a un navigateur 
Internet. 

PHP (Hypertext Preprocessor) est un langage 
de script HTML inspire des langages C, Java et Perl. 
ASP {Active Server Page) est un langage proprie- 
taire de Microsoft pour les developpements web. 



A HTTP 



HyperText Transfer Protocol est un protocole 
de communication pour transferer les documents 
(HTML, image, etc.) entre le serveur HTTP et le 
navigateur web. Ce protocole utilise plusieurs 
types de requetes (commandes) pour demander au 
serveur d'effectuer une action : 

• GET : demander une ressource au serveur ; 

• HEAD : ne demander que des informations sur 
la ressource ; 

• POST : ajouter une nouvelle ressource ; 

• PUT : remplacer ou ajouter une ressource sur le 
serveur ; 

• DELETE : supprimer une ressource du serveur. 
► http://www.w3.org/Protocols/ 



Approfondir Servlet 



Java Servlet Technology 
► http://java.sun.com/products/servlet/ 
(B Jean-Luc Deleage, JSP et Servlets 

efficaces : production de sites 

dynamiques en Java, Dunod, 2007 
£0 Jason Hunter, William Crawford, Servlets 

Java : Guide du programmeur, O'Reilly, 

20021 



Le duo Servlet-JSP 

Une application web, c'est avant tout un aspect visuel. Les pages qui 
constituent le site, utilisent plusieurs artefacts pour avoir un rendu gra- 
phique. Tout d'abord, une page est essentiellement constituee de balises 
HTML qui sont interpreters et affichees par un navigateur. Conjointe- 
ment a HTML, on peut aussi utiliser des feuilles de style (Cascading 
Style Sheets ou CSS) pour enrichir les possibilites graphiques. 

Cependant, un site web n'est pas uniquement constitue de pages stati- 
ques, de sons, d'images et de couleurs. II est necessaire d'y ajouter des 
donnees provenant de traitements cote serveur pour obtenir un contenu 
dynamique. Pour cela, la plate-forme Java EE met a disposition plu- 
sieurs specifications comme les servlets, les pages JSP, les taglibs ainsi 
que JSF. 

Les servlets 

Bien que le developpement de l'application YAPS Pet Store n'utilise pas 
les servlets mais les JSP (Java Server Pages), les balises JSTL (JSP Stan- 
dard Tag Library) et JSF (Java Server Faces), une petite introduction est 
necessaire. 

Fonctionnant cote serveur au meme titre que CGI, ASP ou PHP, les 
servlets permettent de gerer des requetes HTTP, d'effectuer des traite- 
ments, d'appeler des EJB, des services, et de fournir au navigateur une 
reponse sous forme de page web. Les servlets implementent les classes et 
les interfaces des paquetages javax. servlet (classes generiques indepen- 
dantes du protocole) et javax. servlet. http (specifique au protocole 
HTTP). Elles etendent la classe javax. servlet. GenericServlet ou, 
plus couramment, j avax . se rvl et . http . HttpSe rvl et. 

En pratique, les servlets, socle omnipresent de Java EE, ne sont plus utilisees 
directement dans la programmation d'un site web. En effet, elles souffrent 
de nombreuses lacunes, comme l'absence de separation entre les traitements 
et la presentation ou encore l'aiguillage d'une servlet a une autre. 
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Le code ci-apres nous montre un extrait de servlet affichant la liste des 
produits pour une categorie donnee. 

Extrait de servlet melant traitement et presentation 

public class ShowProductsServlet extends HttpServlet { 

public void service(HttpServl etRequest request, 

HttpServl etResponse response) throws ServletException { 
response . setContentType("text/html ") ; 
PrintWriter out = response . getWri ter() ; 

Context initalContext = new InitialContextO ; 
CatalogLocal catalogLocal = (CatalogLocal) 

i ni tal Context . 1 ookup("e j b/statel ess/Catal og") ; 

Long categoryld = Long . val ueOf ( 

request . getAttri bute(" categoryld")) ; 
Category category = catalogLocal . f indCategory(categoryld) ; 
Li st<Product> products = category. getProducts () ; 

out.println("<HTML>") ; 
out.println("<HEAD>") ; 

out . pri ntl n("<TITLE>Di spl ay Products</TITLE>") ; 
out.println("</HEAD>") ; 
out.println("<BODY>") ; 
out.println("<TABLE>") ; 



for (Product product 



out.println( 
out.println( 
out.println( 



<TR>") 
"<TD>") 
"<A href 



out.println(product.getNameQ) ; 



out.println( 
out.println( 



out.println( 
out.println( 



products) { 



'>"); 



</A>") ; 
<BR>") ; 



out . pri ntl n (product . getDescri ptionQ ) ; 



'</TD>"); 
, '</TR>"); 



} 

out.println("</TABLE>") ; 
out.println("</BODY>") ; 
out.println("</HTML>") ; 
out.close() ; 



} 
} 

Comme le montre cet exemple, le code n'est pas tres elegant et peut 
rapidement devenir illisible. On y melange des traitements Java (l'appel 
a l'EJB) et de la presentation HTML (souvent avec des images, des 
styles, des animations, etc.). Dans le cas de pages complexes, le code 
devient vite difficile a maintenir. Pour ne pas se retrouver dans ce cas de 
figure, les JSP sont venues simplifier le developpement de pages web. 



< Une servlet etend la dasse HttpServl et. 



< Point d'entree d'une servlet. 



Lookup JNDI pour obtenir I'interface locale de 
l'EJB CatalogBean. 



L'EJB retourne la liste des produits pour une 
categorie donnee. 



La servlet prepare la reponse a renvoyer au navi- 
gateur sous forme de HTML. 



On itere la liste des produits pour en afficher le 
nom et la description sous forme de tableau 
(balises TABLE, TR et TD). 
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APPROFONDIR JSP 



CO Anne Tasso, Sebastien Ermacore, 

Initiation a JSP, Eyrolles, 2004 
CQ Simon Brown, Sam Dalton, Daniel Jepp, 

Dave Johnson, Sing Li, Matt Raible, Pro 

JSP 2, Apress, 2005 
CO Jean-Luc Deleage, JSP et Servlets 

efficaces, Dunod, 2007 
(B Francois-Xavier Sennesal, JSP avec Eclipse 

et Tomcat, ENI, 2007 
JavaServer Pages Technology : 

► http://java.sun.com/products/jsp/ 
The JSP Resource Index : 

► http://www.jspin.com/ 



Lookup JNDI pour obtenir I'interface locale du 
stateless Catal ogBean. 



L'EJB retourne la liste des produits pour une 
categorie donnee. 



On itere la liste des produits. 



On affiche le nom et la description du produit. ► 



Web Extensions des pages JSP 

Les fichiers de pages JSP portent I'extension . j sp. 
Lorsqu'une page est developpee pour produire de 
I'XHTML, elle a I'extension . jspx. Pour les frag- 
ments de page (en-tete, menu, pied de page), il est 
courant d'utiliser I'extension . j spf . 



Les JSP 

Les JSP permettent l'affichage de contenus dynamiques de maniere plus 
lisible que les servlets. Elles consistent en une page HTML, incluant des 
directives JSP et du code Java, page qui sera ensuite precompilee en ser- 
vlet, puis executee dans un conteneur web. La page est principalement 
constitute de balises HTML pour l'affichage, et de code Java pour les 
traitements. C'est un peu l'inverse de la servlet. 

Lexemple ci-apres nous montre une JSP qui effectue le meme traite- 
ment, c'est-a-dire afficher la liste des produits pour une categorie. 

Extrait de JSP appelant un EJB pour afficher des produits 

<%@ page import="com. yaps. petstore. entity. catalog. Product" %> 

<%@ page import=" java. uti 1 . Li st" %> Q 

<%@ page import="javax. naming. Initial Context" %> 

(...)" 

<TABLE> © 

<% © 

Context initalContext = new InitialContextO ; 
CatalogLocal catalogLocal = (Catal ogLocal) Q 

i ni tal Context . 1 ookup ("e j b/statel ess/Catal og") ; 

Long categoryld = Long.valueOf ( 

request . getAttri bute ("categoryld")) ; 
Category category = catalogLocal . findCategory(categoryld) ; 
List<Product> products = category. getProducts() ; 0 

for (Product product : products) { 0 
%> © 

<TR> 
<TD> 

<A href =""><%= product. getName() %></A> Q 
<BR><%= product .getDescription()%> 

</TD> 
</TR> 
<%}%>© 
</TABLE> © 

La directive import Q possede le meme comportement que l'import en 
Java. Dans notre cas, elle permet d'importer l'entity Product, la classe 
java. uti 1 .List et d'autres classes comme celles de JNDI. Grace aux 
scriptlets ©, on peut inclure du code Java dans la page et, par exemple, 
rechercher un EJB dans JNDI ©, puis l'invoquer pour qu'il retourne la 
liste des produits 0. A l'aide d'une boucle for 0, on affiche dans un 
tableau HTML © le nom du produit ainsi que sa description © en uti- 
lisant l'expression (<%=). 
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S 

Si 

-e 

Les balises JSP = 

Pour declarer, executer ou manipuler des objets Java, les JSP utilisent 
plusieurs types de balises : 

• La directive (<%@ %>) est une instruction inseree dans des balises HTML 
specifiques. 

<%@ page import="java.util .Date"%> 

• La declaration (<%! %>) permet d'inserer du code declaratif dans la 
JSP. Elle peut etre utilisee pour definir une variable globale a la classe 
ou pour creer des methodes Java. 

<%! int i = 0; %> 

• Le scriptlet (<% %>) est utilise pour placer du code dans la JSP. C'est 
generalement I'element utilise pour placer tout code Java, sauf les 
methodes et les variables de classe. 

<% int i = 0; 

out.println("Affiche la valeur d'une variable : " + i); %> 

• L'expression (<%= %>) sert a afficher du texte ou un resultat. Ce code 
est equivalent a un appel out.print(). 

Valeur de variable : <%= i %> 

• L'action permet de fournir des instructions a I'interpreteur JSP. 

<jsp : useBean i d="address" class="com . yaps . petstore . enti ty . Address"/> 



Vous l'aurez compris, ce genre de page melant code Java et balises 
HTML est a peine plus lisible que la servlet que nous avons vue prece- 
demment. La page peut vite devenir compliquee a lire, a maintenir, et 
rapidement compter plusieurs centaines de lignes de code. 

Pour resoudre ce probleme, il est necessaire de separer les responsabilites 
entre composants : les servlets executent les traitements, appellent les 
EJB, gerent les exceptions et renvoient le resultat a la JSP qui l'affiche. 
Cette fa9on de decorreler traitement (servlet) et presentation (JSP) est 
inspiree du design pattern MVC (Model-View-Controller) . 

Le design pattern MVC 

Le design pattern Modele-Vue-Controleur permet d'organiser une 
application en trois composants principaux : 

• un modele, qui correspond aux donnees de l'application (dans notre 
cas, les entities) ; 

• une vue, qui correspond a la presentation visuelle de l'application (la 
JSP); 

• un controleur, qui definit l'etat de la vue en fonction des donnees 
gerees par le modele (la servlet). 



Approfondir MVC 

Model View Controller : 
► http://c2.com/cgi/ 
wiki?ModelViewController 
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Figure 7-1 

Le design pattern MVC 
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APPROFONDIR Requete et reponse HTTP 

L'objet javax . servl et . Servl etRequest 
encapsule la requete du client, c'est-a-dire qu'il 
contient I'ensemble des parametres passes a la 
servlet (informations sur I'environnement du 
client, cookies du client, URL demandee, etc.). 
L'objet Servl etResponse, quant a lui, permet 
de renvoyer une reponse au navigateur. II est ainsi 
possible de creer des en-tetes HTTP (headers), 
d'envoyer des cookies au navigateur du client, etc. 



La servlet transmet la liste des produits a la JSP. 
La portee de cette liste est la requete. 



1 Par le biais d'une page web, l'utilisateur emet une requete HTTP au 
serveur web en cliquant sur un lien ou sur un bouton. Cette requete 
est prise en charge par le controleur (servlet). 

2 Le controleur execute les traitements necessaires (appelle un EJB sta- 
teless par exemple) et recupere le modele, c'est-a-dire les entities. 

3 Le controleur selectionne alors la JSP qui sera en charge de la cons- 
truction de la reponse et lui transmet les entities contenant les don- 
nees a afficher. 

4 La JSP construit la reponse en faisant appel aux accesseurs des enti- 
ties. 

5 La reponse HTTP est transmise au navigateur qui l'affiche sous 
forme de page web. 

Pour reprendre l'exemple de l'affichage des produits, imaginez que 
l'appel a l'EJB se fasse dans une servlet et que celle-ci transmette la liste 
des produits a une JSP. Voici ce a quoi ressemblerait cette JSP. 

Exemple de JSP recevant des donnees d'une servlet 



<%@ page import= 
<%@ page import= 

<TABLE> 



'com . yaps . petstore . enti ty . catal og . Product" %> 
'java.util .List" %> 



<jsp:useBean i d="products" class="List<Product>" Q 

scope=" request "/> 
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<% 



%> 



for (Product product : products) { Q 



On parcourt la liste des produits. 



<TR> 
<TD> 

<A href =""><%= product. getNameO %></A> Q 
<BR><%= product .getDescription()%> 

</TD> 
</TR> 

<% } %> o 

</TABLE> 

La servlet invoque un EJB, recoit la liste des produits, et passe cette liste 
a la JSP O qui peut alors y acceder grace a la directive jsp:useBean. On 
continue a utiliser du code Java dans les scriptlets pour parcourir 0 la 
liste des produits. On affiche alors le nom du produit et sa description © 
dans un tableau HTML. 

Comme on peut le constater en comparant les trois extraits de code prece- 
dents (servlet melant traitement et presentation, JSP appelant un EJB et 
JSP recevant les donnees d'une servlet), le design pattern MVC apporte 
une nette amelioration dans la lisibilite et la maintenance du code tout en 
separant les responsabilites. La JSP n'est plus encombree de code JNDI 
pour appeler l'EJB par exemple. II reste tout de meme encore un peu de 
code Java dans la page (la boucle for dans notre exemple) qui complique la 
lecture du code (la fin de la boucle for qui se trouve en bas de la page Q 
n'est pas facilement reperable). Les bibliotheques standards de balises, ou 
JSTL, peuvent encore ameliorer la comprehension de la page. 



On affiche le nom et la description du produit 
dans un tableau HTML. 



Architecture Separation of Concerns (SoC) 

La separation des responsabilites permet de 
separer differents aspects d'un probleme afin de 
pouvoir se concentrer plus efficacement sur 
chacun. 

► http://en.wikipedia.org/wiki/ 
Separation_of_concerns 

► http://www.latece.uqam.ca/publications/ 
mili-kharraz-mcheick.pdf 



Scope d'un objet 



Les objets crees dans les JSP, les servlets ou les managed beans JSF, que 
nous verrons par la suite, ont une certaine portee (ou champ d'applica- 
tion), c'est-a-dire une certaine duree de vie. Les differents scopes sont 
les suivants : 

• Page : duree de vie tres courte. Les objets ne sont accessibles que dans 
la page ou ils sont definis. 

• Request : duree de vie courte. Les objets sont accessibles pendant la 
duree de la requete, c'est-a-dire entre le moment ou elle est inter- 
cepted par le conteneur et le moment ou la reponse est envoyee. 

• Session : duree de vie longue. Les objets sont accessibles pendant 
toute la duree de la session, par exemple entre le moment ou un utili- 
sateur se connecte a un site puis se deconnecte. 

• Application : duree de vie tres longue. Les objets sont accessibles 
: toute la duree de vie de I'application. 
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Le langage d'expression 

Avant de decrire JSTL, il faut introduire le langage d'expression utilise 
dans les JSP. Le langage d'expression, ou Expression Language (EL), 
permet de manipuler des donnees plus simplement qu'avec les scripdets 
(<% %>). 

Une expression est de la forme suivante : 
| ${ exp } 

La chaine exp correspond a 1' expression a interpreter. Une expression 
peut etre composee de plusieurs termes separes par des points (notation 
pointee). Ainsi, pour acceder a la propriete name de notre entity Product, 
on utilise la syntaxe suivante : 

| ${ product. name } 

En fait, ce nest pas l'attribut name qui est appele, mais la methode 
getNameO puisque les accesseurs sont utilises par introspection pour 
acceder aux proprietes d'un objet. Cette syntaxe remplace celle que nous 
avons vue precedemment : 

| <%= product. getName()%> 

JSTL 

En utilisant le design pattern MVC, on separe les traitements de la pre- 
sentation, c'est-a-dire le code Java, du code HTML. Cependant, il est 
souvent necessaire d'effectuer de la logique d'affichage. Par exemple, 
imaginons les cas de figures suivants : « si le client est connecte, alors 
j'affiche un lien dans l'en-tete de ma page », ou, « tant que la fin de ma 
liste d'objets n'est pas atteinte, je la parcours ». Dans ce genre de cas, il 
faut avoir recours aux scriptlets pour rajouter des i f et des for. Pour pal- 
lier ce probleme, il est possible d'utiliser JSTL (JSP Standard Tag 
Library), ou bibliotheque de balises standards pour JSP. 

Le but avoue de JSTL est l'utilisation de balises XML afin d'eviter de 
placer du code Java dans les JSP. C'est done un ensemble de balises, 
regroupees dans quatre bibliotheques, qui proposent des fonctionnalites 
courantes comme : 

• la bibliotheque Core : iteration, condition, gestion des URL ; 

• la bibliotheque XML : manipulation de donnees en provenance d'un 
document XML, transformation XSLT ; 

• la bibliotheque I18n : internationalisation des messages, des dates, 
des nombres ; 



• la bibliotheque Database : acces aux bases de donnees, definition de 
sources de donnees, execution de requetes SQL. 

Dans le cadre du developpement de Implication YAPS Pet Store, seule 
une partie de la bibliotheque Core presente un interet. Si vous souhaitez 
approfondir cette vaste specification, reportez-vous aux references sui- 
vantes. 

La bibliotheque Core contient les balises pour afficher des messages ou 
des attributs d'objets (out), pour conditionner une partie de la page (if, 
choose) ou pour iterer (forEach). Voyons dans l'exemple ci-apres com- 
ment afficher une liste de produits en utilisant JSTL. 

Exemple de JSP contenant des balises JSTL 

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jst"l/core"%> 

o 

<%@ page import="com. yaps . petstore . enti ty. catalog . Product" %> 
<%@ page import="java.util .List" %> 

<TABLE> 

<jsp:useBean id="products" cl ass="Li st<Product>" < 

scope=" request "/> 

<c:forEach var="product" items="${products}"> Q < 
<TR> 
<TD> 

<A href=""xc:out val ue="${product . name}"/x/A> 0 < 
<BRxc:out val ue=" ${product . description }"/> 
</TD> 
</TR> 

</c:forEach> Q 

</TABLE> 

L'exemple precedent melange les directives JSP (jsp:useBean) avec les 
balises JSTL (forEach, out) et le langage d'expression. Pour utiliser la 
bibliotheque Core de JTSL, il faut la declarer dans la page Q a l'aide 
d'une directive JSP. Cette ligne de code nous informe de l'URL de la 
bibliotheque, mais aussi du prefrxe utilise dans la page. Toutes les balises 
prefixees par la lettre c correspondent a la bibliotheque Core. Ensuite, 
on peut parcourir © la liste des produits avec la balise forEach. Celle-ci 
prend en parametre la liste d'objets (products) puis definit un index 
(product) sur lequel iterer. On affiche alors le nom du produit et sa des- 
cription © a l'aide de la balise out. Comme vous pouvez le constater, le 
code se limite a des balises XML, le rendant beaucoup plus simple a lire 
et a comprendre. 



Approfondir jstl 

JavaServer Pages Standard Tag Library : 

► http://java.sun.com/products/jsp/jstl/ 
index.jsp 

► http://java.sun.com/products/jsp/ 
taglibraries.html 

Q Shawn Bayern, JSTL in Action, Manning, 
2002 

Q Sue Spielman, JSTL - Practical Guide for 
JSP Programmers, MK Publishers, 2003 



Si la JSP utilise un ou plusieurs tags de la biblio- 
theque Core, il faut le declarer avec une directive 
taglib. 



Grace au design pattern MVC, la servlet invoque 
un EJB et transmet la liste des produits a la JSP 
qui peut ensuite y acceder grace a la balise 
jsp:useBean. 

La balise forEach itere la liste d'objets 



La balise out affiche la valeur retournee par 
I'expression ${product . name} . 



JSTL Les balises personnalisees 

JSTL possede une API qui permet de creer ses pro- 
pres balises (Custom Tags). Ecrites en Java et 
decrites en XML, elles sont ensuite regroupees dans 
une bibliotheque (taglib) pour etre reutilisees dans 
des JSP. Cette extension de la technologie JSP est 
apparue a partir de la version 1.1 de la specification. 



171 



Retour d'experience 

La separation des traitements et de la presentation dans les equipes 

Nous venons de voir I'importance du design pattern MVC et de la repar- 
tition des responsabilites entre traitements et presentation. Ce decou- 
page se fait aussi naturellement dans une equipe de developpement. 
On y retrouve ainsi des developpeurs Java s'occupant de traitements et 
des designers concevant la charte graphique de I'application, c'est-a- 
dire les pages web. Ces deux technologies, bien que complementaires, 
ont du mal a coexister chez la meme personne. II est difficile de 
demander a un developpeur Java de maTtriser I'art graphique et inverse- 
ment. De plus, un designer risque de rencontrer des difficultes dans la 
manipulation de pages JSP lorsque celles-ci contiennent du code Java, 
puisqu'il ne travaille habituellement qu'avec des langages de balises. 
JSTL presente I'avantage de permettre au designer de continuer a uti- 
liser des balises XML pour la construction de ses pages. Les taglibs (et 
Custom Tags) creent une nouvelle couche d'abstraction qui facilite la 
communication entre les deux langages. 



JSF 



Outils Les frameworks web 

Struts est un des premiers frameworks Open 
Source pour developper des applications web base 
sur le decoupage MVC. 

► http://struts.apache.org/ 

Spring MVC est le composant de navigation web 
du framework Spring. Son concept d'inversion de 
controle (loC) permet notamment de construire 
une architecture web avec des couches indepen- 
dantes les unes des autres. 

► http://springframework.org/go-webflow2 
Tapestry est un autre ordonnanceur respectant le 
paradigme MVC. 

► http://tapestry.apache.org/ 



APPROFONDIR JSF 

► http://java.sun.com/javaee/javaserverfaces/ 

► http://www.jsfcentral.com/ 

£0 Kito Mann, JavaServer Faces in Action, 
Manning, 2005 



Toutes les technologies que nous venons de voir sont necessaires pour 
developper une application web et se completent mutuellement. Par 
contre, rien dans les specifications ne nous oblige a utiliser un modele de 
programmation particulier (MVC par exemple). La navigation entre 
pages n'est pas non plus specifiee, il est done possible de la creer de diffe- 
rentes manieres plus ou moins elegantes (en dur dans les senders, via un 
fichier de configuration, etc.). II manquait un modele un peu plus rigide 
permettant de savoir clairement dans quel composant developper les 
traitements, ou concentrer la presentation et comment naviguer entre les 
pages. Ce modele est apparu avec JSF. 

Java Server Faces permet de developper des applications web en benefi- 
ciant de concepts deja eprouves par Java et Java EE (composants graphi- 
ques Swing, modele de programmation evenementiel, JSP, servlets, 
JSTL, langage d'expression), et par les apports d'autres framework Open 
Source tel que Struts. 

JSF ne remplace pas les autres technologies web, il les utilise et les com- 
plete. 

• Les servlets constituent le fondement de la technologie web et jouent 
le role de controleur du modele MVC. La specification precise aussi 
comment packager et deployer une application. 

• Les JSP permettent de generer la partie graphique en utilisant des 
langages tels que HTML ou CSS (Cascading Style Sheets). 
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• Les balises JSTL simplifient le developpement des pages JSP en 
ajoutant de la logique de presentation au format XML. 

• Les langages d'expressions (EL et UEL que nous verrons par la suite) 
permettent d'acceder simplement aux objets. 

A tout cela, JSF apporte plusieurs fonctionnalites destinees a resoudre 
les problemes inherents a la programmation web. JSF se compose d'un 
ensemble d'API fournissant notamment : 

• une separation nette entre la couche de presentation et les autres 
couches ; 

• une librairie de composants graphiques ; 

• un mode de programmation evenementiel pour ces composants ; 

• la navigation entre pages ; 

• le traitement des formulaires et leur validation ; 

• la gestion des exceptions et l'affichage de messages d'erreur ; 

• la conversion des types primitifs provenant des donnees d'applica- 
tions vers des objets de plus haut niveau (String vers Objets) ; 

• la gestion de clients heterogenes (HTML, WML, XML...) ; 

• l'independance des protocoles (HTTP, WAP...) ; 

• la creation ou l'enrichissement de composants graphiques (custom) ; 

• la gestion de l'etat des composants entre requetes ; 

• la difference de comportement entre navigateurs. 

Ce livre ha pas la pretention de couvrir toutes les particularites de JSF. 
Nous ne nous attarderons que sur les balises graphiques, les traitements 
et la navigation entre pages. 

Les balises JSF 

JSF fournit aux developpeurs une large palette d'outils leur permettant 
d'implementer des applications web en respectant un modele base sur 
des composants graphiques (liste deroulante, zone de saisie, tableau, 
etc.). Chaque composant reagit ensuite a un ensemble d'evenements 
(clic, changement de texte, etc.). 

Le support de la partie graphique reste toujours une page JSP dans 
laquelle on rajoute les balises JSF. La page est done constituee de com- 
posants graphiques qui s'imbriquent les uns dans les autres (une page 
contient un formulaire, qui est constitue de zones de saisie et de bou- 
tons) formant ainsi un arbre. Ces balises sont ensuite interpreters pour 
etre transformers en HTML pour une application web, ou en WML 
pour une application destinee aux PDA. 



Application 
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JSF 



JSF 
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Tags 
Custom 



JSP 



Servlet 



Figure 7-2 

Technologies autour de JSF 

Architecture Le pattern observateur 

Lorsqu'on parle de programmation evenemen- 
tielle, on pense souvent au pattern observable. 
Couramment utilise dans les interfaces graphiques 
(e'est le cas de Swing et de JSF), ce pattern permet 
d'alerter des objets interesses par un changement 
d'etat (le contenu d'une zone de saisie qui change, 
un clic sur un bouton, etc.). Des objets demandent 
a observer (a recevoir une notification) le change- 
ment d'autres objets. 

► http://www.design-patterns.fr/ 
Observateur.html 

► http://c2.com/cgi/wiki70bserverPattern 



A WAP et WML 

Le Wireless Application Protocol (WAP) est un 
protocole de communication dont le but est de 
permettre I'acces a Internet a I'aide d'un terminal 
mobile (par exemple un telephone portable, un 
PDA, etc.). WML, Wireless Markup Language, 
est son langage de balises. 



Architecture Le design pattern composite 

Lorsqu'on parle de structure en arbre, on evoque 
souvent le design pattern composite. Ce design 
pattern determine une representation en arbre 
d'une structure de donnees. En general, une com- 
position est une collection d'objets, et tout objet 
peut etre une composition (un noeud) ou un objet 
primitif (une feuille). 

► http://c2.com/cgi/wiki7CompositePattern 
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Bibliotheque Core. 



Bibliotheque HTML. 



JSF utilise deux librairies de balises, HTML et Core, definies dans les 
pages JSP par les directives suivantes : 

JSP declarant les balises JSF 

<%@ taglib uri="http://java. sun.com/jsf/core" prefix="f" %> 
<%@ taglib uri="http://java. sun.com/jsf/htmT' prefix="h" %> 

Cette declaration implique que les balises Core seront prefixees par f 
(<f : view>) et les balises HTML par h (<h :commandl_i nk>). 



JSF Le rendu des balises 



La bibliotheque de balises HTML est utilisee pour 
les rendus (Renderer) graphiques propres au Ian- 
gage HTML. Si vous voulez afficher une page pour 
un telephone portable, une application Telnet, etc., 
il vous faudra utiliser une librairie differente. II en 
existe plusieurs comme, par exemple, ADF 
d'Oracle. 

► http://www.oracle.com/technology/ 
product s/jdev/htdocs/partners/addins/ 
exchange/jsf/ 



Les balises HTML 

Les balises HTML de JSF servent au rendu graphique. Lidee est de 
s'affranchir des balises HTML classiques et d'utiliser celles de JSF pour 
avoir des pages portables selon les navigateurs, repondant a des evene- 
ments, et s'integrant facilement aux traitements effectues par le controleur. 

Dans les balises HTML de JSF, il y a tout d'abord celles qui vous per- 
mettent d'afficher ou de saisir du texte sous differentes formes. 
outputText O affiche un message ou le contenu d'une variable, alors que 
inputText © definit une zone de saisie et affecte la valeur a un objet. 
i nputSecret 0 est l'equivalent pour les zones de saisie de mot de passe. 

Lorsque vous validez un formulaire qui comporte des donnees erronees, 
ou qu'une exception systeme intervient, il est necessaire d'en informer 
l'utilisateur. La balise message Q repond a cette fonctionnalite en affi- 
chant les messages d'erreurs sur la page. 



Balise JSF 



<h:outputText val ue="#{cart . customer . 1 astname}"/> Q 



<h: inputText val ue="#{cart . customer . fi rstname}" /> 0 



Smith 



<h : i nputSecret val ue="#{account . password}" 0 
maxl ength="10" 
size="12"/> 



<h:message style="color: red"/> Q 

Login: <h:inputText value="#{account.login}"/> 
Pwd: <h : i nputSecret val ue="#{account . pwd}"/> 
<h : commandButton value="Sign In" 

action="#{account . doSignln}" type="submit"/> 



Invalid login password - 
Login: [job ~ 



Save | 



Une page comporte tres souvent des boutons ©, des liens 0, des images 
O, ou des images 0 qui se comportent comme des liens. Dans ce der- 
nier exemple, on s'apercoit qu'il est possible d'imbriquer des balises entre 
elles (commandLink contient une balise graphiclmage). 



174 



<h : commandButton value="Sign In" 0 
action="#{account.doSignIn}" 
type="submit"/> 


I Sign In [ 


<h: commandLi nk action="#{account.doSignIn}"> 0 

<h : outputText value="Sign In"/> 
</h : commandLi nk> 


Sign In 


<h:graphiclmage url="images/bi rdl. jpg"/> Q 




<h : commandLi nk acti on="#{catal og . doShowItem} "> 

<h:graphiclmage url="images/bi rdl. jpg"/> 0 
</h : commandLi nk> 




11 existe bien d'autres composants graphiques disponibles dans JSF 
(comme les checkbox, les radioboutton, les listbox, etc.). Cet ouvrage ne 
se focalise que sur ceux qui seront utilises dans 1' application tels que la 
combobox 0 ou le tableau ©. 








Arretons-nous un instant sur la balise dataTabl e 0. Elle permet d'iterer 
une liste (dans l'exemple, une liste de produits), de la formater sous 
forme de tableau (en utilisant la balise col umn) et de manipuler un index 
pour en obtenir des informations (ici la variable product designe un pro- 
duit unitaire). Pour afficher les attributs name et description du produit, 
il suffit d'utiliser la balise outputText. 








Balise JSF Rendu graphique 


<h:selectOneMenu value="#{cart.creditCard.type}"> 0 
<f : sel ectltem i temLabel ="Vi sa"/> 
<f : sel ectltem i temLabel ="Visa Gold"/> 
<f: sel ectltem itemLabel="Master Card"/> 

</h : sel ectOneMenu> 


Visa v 


<h:panelGrid columns="4"> ([•) 
<h : outputText value="l" /> 








<h: outputText value="2" /> 
<h: outputText value="3" /> 
<h: outputText value="4" /> 
<h:outputText value="5" /> 
<h : outputText value="6" /> 
<h : outputText value="7" /> 
</h : panel Crid> 




□□on 

EEE 
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<h:dataTab1e value="#{catalog. products}" var="product"> 
<h:column> (ft 

<h : outputText val ue="#{product . name}"/> 
</h : col umn> 
<h : col umn> 

<h : outputText val ue="#{product . descri pti on}"/> 
</h : col umn> 
</h :dataTabl e> 



Bulldog 


||Excellent odorat 


|Caniche 


||Petit chien 



JSF Les balises sont des classes 

Les balises JSF sont definies par des classes Java 
qui se trouvent dans le paquetage 
javax . faces . component. Chaque classe 
herite de UlComponent qui definit un certain 
nombre de methodes pour interagir avec les 
managed beans, avoir un rendu graphique, con- 
verts ou valider des donnees, etc. 



JSF Convention de nommage des balises 

Les balises peuvent etre prefixees par ce que Ton 
veut. II est pourtant commun d'utiliser la lettre c 
pour le Core JSP, h pour les balises HTML de JSF, et 
f pour le Core JSF. 



JSF Creer ses propres convertisseurs 

Un convertisseur est une classe Java qui doit 
implementer les methodes de I'interface 
j avax . faxes . convert . Converte r. 
Suivez les etapes a I'adresse suivante : 
► http://www-128.ibm.com/developerworks/ 
Iibrary/j-jsf3/ 



Certaines balises JSF n'ont cependant pas de rendu graphique immediat 
comme la balise <h : form> qui permet de gerer les formulaires. 

II faut bien comprendre que chacune de ces balises sera transformee en 
HTML pour ensuite constituer une page et etre affichee par un naviga- 
teur. Par exemple, la balise JSF suivante : 

<h:inputText val ue="#{cart . customer . fi rstname}" /> 

sera transformee en HTML comme ceci : 
J <input type="text" value="Smith" /> 

Les balises Core 

Contrairement a la bibliotheque HTML, les balises Core n'ont pas de 
rendu graphique specifique. Par convention, elles sont prefixees par la 
lettre f. Voici une liste non exhaustive de balises Core utilisees dans 
Implication. 

Attachons-nous aux balises principales dans un premier temps. Les 
balises vi ew Q et subvi ew © permettent a votre page de contenir d'autres 
balises JSF et de pouvoir etre interpretees. Elles se retrouvent generale- 
ment en debut et en fin de la JSP. La seule difference entre ces deux 
balises, se resume par le fait que subvi ew est utilisee pour les fragments 
de pages, c'est-a-dire les en-tetes, menus ou bas de page. 

La plupart des balises autorisent l'ajout de parametres en incluant la 
balise param Q. Pour ce qui est des listes de tout genre (combobox, 
listbox), on peut rajouter des libelles avec la balise selectltem Q. 

Lors de l'affichage de donnees, il est bien souvent necessaire de les for- 
mater. Par exemple, on peut citer la conversion de dates au format jj/mm/ 
aaaa, d'un entier avec deux chiffres apres la virgule, etc. JSF possede deux 
balises standards pour vous faciliter la tache convertDateTime 0 et 
convertNumber. JSF vous permet aussi de creer vos propres convertisseurs. 
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<f:view> © 

Page JSP utilisant des balises JSF 
</f : view> 


Une page JSP voulant utiliser des balises JSF doit 
les placer dans cette balise. Elle se trouve gene- 
ralement en debut et en fin de page. 


<f:subview> Q 

Sous-page JSP utilisant des balises JSF 
</f : subview> 


Cette balise permet de creer des fragments de 
page qui pourront ensuite etre englobes. Cou- 
ramment utilise pour les en-tetes, menus, ou bas 
de page. 


<h : command Li nk acti on="#{catal og . doFi ndProducts}"> 
<h:outputText val ue="Bi rds"/> 
<f:param name="categoryId" value="5"/> © 

</h : commandLi nk> 


Dans cet exemple, on rajoute le parametre 
categoryld de valeur 5 a la balise 
commandLi nk. 


<h : sel ectOneMenu val ue="#{cart . credi tCard . type}"> 
<f :selectltem i temLabel="Vi sa"/> © 
<f :selectltem i temLabel="Vi sa Cold"/> 
<f : selectltem i teml_abel="Master Card"/> 

</h : sel ectOneMenu> 


On ajoute des libelles dans une combobox. 


<h : i nputText val ue="#{account . customer . dateOf Bi rth}"> 

<f :convertDateTime pattern="dd.MM.yyyy"/> © 
</h:inputText> 


Convertit la date d'anniversaire au format 
dd.MM.yyyy. 



Exemple de page JSP utilisant les balises JSF 

Rien ne vaut un premier exemple de page web complete pour com- 
prendre l'imbrication entre HTML, JSP et librairies JSF. Reprenons 
l'exemple de l'affichage de la liste des produits. 

Extrait de JSP affichant les produits 

<%@ taglib uri="http://java. sun.com/jsf/core" prefix="f"%> © 
<%@ taglib uri="http ://java. sun . com/jsf/html " prefix="h"%> 

<f:view> © 

<h2>Products for category : 

<h:outputText val ue="#{catalog. category. name} "/> © 
</h2> 

<h: messages style="color : red"/> © 
<h : form> 

<h:dataTab1e value="#{catalog. products}" var="product"> © 
<h:column> © 

<h: commandLi nk action="#{catalog.doFindItems}"> © 
<h :outputText val ue="#{product . name}"/> © 
<f:param name="productId" value="#{product.id}"/> 

</h : commandLi nk> 



Approfondir Les balises JSF 



Ce livre ne repertorie que certaines balises JSF. 
Vous pouvez en retrouver la totalite aux adresses 
suivantes : 

► http://horstmann.com/corejsf/jsf-tags.html 

► http://www.exadel.com/tutorial/jsf/jsftags- 
guide.html 



Importe les balises JSF a I'aide de la directive 
tagl i b. 



Les balises JSF doivent etre a I'interieur d'un 
f : vi ew. 



On peut meler balises HTML (h2) et balises JSF. 



Affiche les messages d'erreurs en cas d'excep- 
tions. 



Itere la liste des produits. 



Declare une colonne. 



Cree un lien hypertexte (h : commandLi nk) 
sur le nom du produit (product . name). 
Lorsqu'on clique sur le lien, un parametre 
(f:param) est passe a Taction 
doFi ndltems. 
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Balise HTML de retour chariot. 



Affiche la description du produit. 



Web Extensions des pages JSF 

Les pages contenant des balises JSF sont des 
pages JSP. Elles possedent done I'extension . jsp. 



HTML Un langage de balises 

Le langage HTML est tres riche et comporte beau- 
coup de balises. Dans I'application, nous n'en utili- 
serons qu'une infime partie, comme les balises de 
saut de ligne (br), de police de caracteres (hi, 
h2, strong...) ou de structure (body, head, 
html). Vous pouvez retrouver la liste exhaustive a 
I'adresse suivante : 

► http://www.w3schools.com/tags/ 
default.asp 



<br/> 

<h:outputText value="#{product.description}"/> Q 

</h : col umn> 
</h:dataTable> 
</h : form> 

</f : vi ew> 

Pour utiliser les balises JSF, il faut obligatoirement importer les biblio- 
theques adequates a l'aide des directives tagl i b Q, et les englober dans 
une balise f :view Q. Les balises Core seront alors prefixees par f et les 
balises graphiques par h. 

Pour afficher le nom de la categorie en titre de la page, on utilise la balise 
HTML h2 conjointement avec la balise JSF <h : outputText> 0. Celle-ci 
est utilisee a differents endroits dans la page pour afficher le nom du 
produit © ainsi que sa description ©. 

Le but etant d'afficher une liste de produits, on utilise la balise 
<h :dataTable> 0 pour iterer la collection (catal og . products) et la pre- 
senter sous forme de tableau 0. Pour representer un lien HTML, on 
utilise la balise <h:commandLink> Q. Celle-ci possede un parametre 
action qui permet, comme nous le verrons par la suite, d'appeler une 
methode lorsqu'on clique sur le lien. En cas d'erreur, un message 
d'exception est affiche grace a la balise h : messages Q. 

Le resultat est le suivant : une page web qui affiche en titre le nom de la 
categorie, puis itere la liste de ses produits en affichant leur nom, sous 
forme de lien hypertexte, et leur description (figure 7-3). 



) YAPS PetStore - Products - Mozilla Firefox 



n x 



Products for category : Birds 



Figure 7-3 

Page affichant les produits d'une categorie 



Amazon Parrot 

Great companion for up to 75 years 
Great stress reliever 



Voila pour 1' aspect graphique. Mais qu'en est-il des traitements ? Com- 
ment a-t-on reussi a obtenir une liste de produits ? De plus, dans 
presque tous les exemples que nous venons de voir, les balises utilisent 
frequemment le symbole diese #. Quelle est son utilite ? 
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Le langage d'expression unifie 



Avant d'aborder la partie traitement, nous devons d'abord nous attarder 
sur le langage d'expression unifie et parler un peu du passe. Le langage 
d'expression (EL) que nous avons vu precedemment, est entre dans la spe- 
cification JSP 2.0. II permet d'acceder facilement aux attributs d'un objet. 

| ${ product. name } 

Alors que la specification JSP 2.0 n'etait pas encore terminee, JSF 1.0 est 
apparu avec ses composants graphiques, ses convertisseurs, son mode de 
programmation evenementielle et son langage d'expression. 

| #{ product. name } 

La raison de la creation de ce nouveau langage (# au lieu de $), est prin- 
cipalement due au fait que le JSP EL ne satisfaisait pas le modele JSF. 
En effet, JSP EL evalue une expression a la volee, c'est-a-dire que le 
conteneur resout l'expression au moment oil il interprete la page, puis 
renvoie le resultat. JSF utilise un mode differe puisque l'expression peut 
etre convertie, validee, repondre a un evenement (un clic de souris, une 
valeur qui change) avant d'etre evaluee. Les deux langages ont done leur 
raison d'exister separement. 

Iteration avec JSP EL 

<c:forEach var="product" i tems="${products}"> Q 

<h:inputText val ue="#{product . name}"/> © 
</c:forEach> 

Cet exemple itere une liste de produits $ {products} a l'aide d'une balise 
JSTL forEach, Q et utilise le langage d'expression JSP EL ($). L'expres- 
sion $ {products} est done evaluee immediatement lors de l'interpreta- 
tion de la page. Qu'en est-il de la variable product ? Lorsque la balise 
JSF inputText essaie d'evaluer l'expression #{product.name} Q en dif- 
fere, il est trop tard, la variable n'est plus accessible. Lutilisation des deux 
langages en meme temps peut done faire apparaitre des erreurs. 

Pour resoudre ce probleme, les specifications JSP 2.1 et JSF 1.2 ont 
unifie leur langage. Les deux EL continuent a exister l'un a cote de 
l'autre, chacun avec sa specificite (evaluation a la volee et en differee), 
mais peuvent desormais etre utilises conjointement, ce qui n'etait pas le 
cas auparavant. Grace au langage d'expression unifie (UEL), il est pos- 
sible d'ecrire le code suivant : 



APPROFONDIR UEL 

Unified Expression Language : 

► http://java.sun.com/products/jsp/reference/ 
techart/unif iedEL.html 

► http://java.sun.com/developer/ 
technicalArticles/J2EE/jstl/ 



JSF Cycle de vie d'une page 

Le fait que 1'evaluation soit differee est du au cycle 
de vie de la page JSF qui est bien plus complique 
qu'une page JSP. Nous ne rentrerons pas dans le 
detail, mais il faut savoir que lorsque les balises de 
la page sont interpretees et executees, un arbre 
d'objets Java (les classes derivees de 
javax.faces.component.UIComponent) est cree 
cote serveur. La racine de cet arbre est un objet 
javax.faces.component.UIViewRoot. Cet arbre est 
ensuite transforme (phase de rendu) dans un flux 
propre a la technologie du client : HTML, WML, 
XML, etc. Lorsque le client soumet la vue courante, 
le flux correspondant est decode pour reconstituer 
I'arbre de composants associes. 
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Iteration avec JSF UEL 

<c:forEach var="product" i tems="#{products}"> Q 

<h : i nputText val ue="#{product . name}"/> 
</c : forEach> 

La balise JSTL forEach peut utiliser UEL pour evaluer la liste des pro- 
duits ©. 



JSF La gestion evenementielle 

Le modele MVC que nous decrivons ici est legere- 
ment simplifie. En effet, JSF utilise un mode de pro- 
grammation evenementiel (similaire a Swing). II y a 
done toute une panoplie d'actions handler repon- 
dant a des evenements : ActionLi stener 
lorsqu'on clique sur un bouton ou un lien, ou 
Val ueChangeLi stener lorsque le contenu 
d'une zone de saisie change. Nous n'aborderons pas 
ces concepts avances dans ce livre. 
► http://www.oracle.com/technology/ 
oramag/oracle/04-mar/o24devjsf.html 



Traitements et navigation 

Larchitecture de JSF est basee sur le design pattern MVC. Comme nous 
l'avons vu precedemment dans MVC, les servlets sont utilisees pour 
intercepter une requete, effectuer un traitement, puis deleguer l'affichage 
a une JSP. Les servlets s'occupent done de recuperer les informations de 
la requete, d'effectuer des traitements (appeler des EJB stateless par 
exemple), mais aussi de naviguer entre pages. Dans ce modele, on a done 
une relation 1:1 entre une servlet et une JSP, ce qui, pour creer un site 
complet, multiplie considerablement le nombre de servlets. De plus, les 
regies de navigation sont codees en dur, ce qui rend les modifications 
compliquees. 



Controleur 



Figure 7-4 

Architecture MVC de JSF 



Requete 



1 




Reponse 



JSP 
(balises JSF) 




Entity 



Pour rendre le developpement d'une application web plus modulaire et plus 
souple, JSF decorele tous ces elements (traitement, presentation, navigation) 
et enrichit le pattern MVC. Le modele est toujours represente par les enti- 
ties ©. Par contre, il n'y a qu'un controleur unique (le FacesServlet) qui 
intercepte les requetes HTTP Q, une navigation configurable par fichier 
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XML ©, des traitements delegues a des managed beans © qui manipulent 
le modele © et un rendu graphique utilisant les balises JSF @. 

La FacesServlet 

Le controleur JSF est le point d'entree de toutes les requetes HTTP. II 
est constitue d'une servlet unique nommee FacesServlet. La 
FacesServlet recoit les requetes de la part des clients web, et execute un 
certain nombre d'etapes pour preparer la reponse qui sera affichee par le 
navigateur. Les actions et la navigation entre pages sont parametrables 
par fichier XML (faces-config.xml). 

Pour que cette servlet puisse intercepter toutes les requetes concernant 
JSF, elle doit etre declaree dans le fichier web.xml de 1' application. 

Declarer les servlets dans le fichier web.xml 

Le fichier web.xml est un fichier extremement important dans une appli- 
cation Java EE. Aussi appele descripteur de deploiement, il contient les 
caracteristiques et parametres de I'application, ce qui inclut la descrip- 
tion des servlets utilisees et leurs differents parametres d'initialisation. 
Chaque servlet doit etre declaree dans I'element XML <servlet> de la 
maniere suivante : 

• <servlet-name> est le nom interne de la servlet, nom qui I'identifie 
de facon unique. 

• <servl et-cl ass> est la classe Java associee a la servlet. 

• <load-on-startup> demande que la servlet soit chargee des le 
demarrage du serveur. 

• <servl et-mappi ng> effectue le lien entre I'URL et la servlet. 

• <url -pattern> est I'URL permettant de faire le lien avec la servlet. 
Dans notre cas, chaque URL ayant comme suffixe .faces, invoquera 
automatiquement la FacesServlet. 

Extrait du fichier web.xml 

<servl et> 

<servlet-name>Faces Servl et</servlet-name> 
<servl et-cl ass> 

javax . faces . webapp . FacesServl et 

</servlet-class> 

<load-on-startup>l</load-on- start up> 
</servlet> 
<servl et-mappi ng> 

<servl et-name>Faces Servl et</servlet-name> 

<url -pattern>" . faces</url -pattern> 
</servl et-mappi ng> 



JSF Les implementations 



JSF n'est qu'une specification. II vous faut done 
utiliser une implementation pour pourvoir executer 
des pages et traitements JSF. 
II existe plusieurs implementions, plus ou moins 
abouties : 

• MyFaces d'Apache 

► http://myfaces.apache.org/ 

• Mojarra de Sun (GlassFish) 

► https://javaserverfaces.dev.java.net/ 
Consultez la matrice suivante, comparant les 
implementations : 

► http://www.jsfmatrix.net/ 



< On declare la FacesSe rvl et. 



La servlet est invoquee lorsqu'une ressource 
possede I'extension faces. 
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Approfondir Un bean 



Un bean est une classe Java qui respecte la specifi- 
cation JavaBeans : un constructeur vide, des 
methodes publiques de lecture et de modification 
de ses attributs (getXXX et setXXX), etc. 
► http://java.sun.com/beans/docs/ 



Managed bean. 



La reference de I'EJB est injectee. 



Attributs prives du managed bean accessibles 
uniquement via les methodes publiques get et 
set. 



Methode du bean. 



Alias utilise pour la navigation. 



JSF Nommer les managed beans 

Java EE n'impose pas de regies de nommage pour 
ses composants. Toutefois, il est commun de suf- 
fixer les stateless beans par Bean. En ce qui con- 
cerne les managed beans, pour ne pas repeter le 
suffixe Bean, on peut utiliser Controller ou 
Action. 



Alias qui sera utilise dans les pages. 



Classe Java devant etre prise en compte par JSF. 



Champ d'application du bean. 



Le managed bean 

La FacesServlet delegue les traitements et les appels aux managed 
beans. Un managed bean est une classe dont le cycle de vie est gere par 
JSF. En fait, JSF instancie le bean en fonction de son champ d'applica- 
tion (scope), le stocke dans le contexte JSF, et l'invoque lorsque neces- 
saire. Ci-apres un exemple de managed bean : 

Exemple de managed bean 

public class CatalogController 

@EDB O 

private CatalogLocal catalogBean; 0 

private String keyword; 0 
private List<Item> items; 

public String doSearch() { Q 

items = catalogBean. searchltems(keyword) ; 0 
return "items . found" 0 

} 

// Getters & setters des attributs 

} 

Ce managed bean CatalogController declare deux attributs prives 0 et 
une methode publique 0. Celle-ci appelle la methode searchltems 0 
du stateless session bean (CatalogBean) qui effectue reellement les traite- 
ments metier. La chaine de caracteres 0 retournee par la methode est 
utilisee pour la navigation entre pages. Nous l'expliquerons par la suite. 

Comme vous pouvez le voir, cette classe est tout a fait simpliste. En fait, 
pour devenir managed bean et etre pris en compte par JSF, il faut tout 
simplement la declarer dans le fichier f aces-conf i g . xml . 

Exemple de declaration de managed bean 

<managed-bean> 

<managed-bean-name>cata"log</managed-bean-name> 

<managed-bean-class> 

com . yaps . petstore . j sf . Catal ogCont rol 1 er 

</managed-bean-cl ass> 

<managed-bean-scope>session</managed-bean-scope> 
</managed-bean> 

Revenons sur l'extrait de code du managed bean CatalogController. 
Pour appeler l'EJB, le managed bean peut utiliser son interface locale 
puisqu'ils sont tous deux deployes dans le meme fichier .ear. Par contre, 
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le code n'utilise pas l'API JNDI pour retrouver l'interface. Une des nou- 
veautes de Java EE 5 est le systeme d'injection. Le code precedent declare 
une interface locale 0, et l'annotation @EJB en injecte la reference Q. 

L' injection 

La plupart des applications ont besoin de ressources externes (source de 
donnees, interface d'EJB, file d'attente JMS ou service web). En J2EE 1.4 
le client doit explicitement declarer cette dependance dans des descrip- 
teurs de deploiement XML et en obtenir une reference a I'aide de JNDI. 

En Java EE 5, ces references sont instanciees par le conteneur lui-meme, 
puis injectees dans les objets manages. Ce mecanisme est appele injec- 
tion (en anglais Dependency Injection, ou Inversion of Control - IoC). 
Cette injection de dependance ne peut etre utilisee que pour des objets 
pris en compte par le conteneur. 

L'application Swing etant distante et executee en dehors d'un conteneur 
client (ACC), elle ne peut pas utiliser ce mecanisme d'injection et doit 
avoir recours aux lookups JNDI. Les managed beans, quant a eux, s'exe- 
cutent a l'interieur du conteneur web et peuvent done utiliser le meca- 
nisme d'injection. JNDI est, bien stir, toujours sollicite mais de facon 
plus discrete. Le developpeur n'a plus besoin de manipuler directement 
l'API JNDI. 

L'injection de l'EJB se fait grace a l'annotation Ojavax . ejb . EJB. 
Code de l'annotation @javax.ejb.EJB 
package javax.ejb; 

©Target (value={TYPE, METHOD, FIELD}) @Retention(va"lue= 
RUNTIME) 

public @i interface EJB { 
String name() default ""; 
String descriptionO default ""; 
String beanName() default ""; 

Class beanlnterfaceO 

String mappedName() default ""; 

} 

En annotant un attribut avec @EJB, le conteneur l'initialise automatique- 
ment avec la reference vers l'EJB (ou plus precisement son interface 
locale). Cette initialisation se produit avant qu'aucune autre methode ne 
soit appelee. Notre code ne contient alors plus aucune API technique 



Architecture Principe de l'injection 

Martin Fowler est a I'origine du terme Depen- 
dency Injection, ou injection. Au lieu de faire un 
lookup de l'interface de l'EJB, celle-ci est injectee 
par le conteneur dans le managed bean. 
► http://www.martinfowler.com/articles/ 
injection.html 




Figure 7-5 L'injection 



< S'applique a une classe, une methode ou un 
attribut. 



< Norn JNDI de l'EJB utilise. 
i Description. 

< Norn de l'EJB. Correspond au nom defini dans 
l'annotation @Statel ess de l'EJB. 

< Classe de l'interface retournee par le lookup. 

< Reference a l'EJB specifique au serveur d'appli- 
cations. Non portable. 
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(JNDI), et la resolution des dependances est fortement typee (les opera- 
tions de cast ne sont pas necessaires). 

La glue entre le managed bean et la page 

D'un cote, nous avons des managed beans qui contiennent des attributs, 
des methodes, et de l'autre nous avons des pages JSP qui affichent ces 
attributs et invoquent ces methodes. Le lien entre les deux se fait par le 
langage d'expression. Prenons l'exemple d'un managed bean qui declare 
un attribut keyword de type String : 

Exemple de managed bean declarant un attribut 

public class Catal ogController 
private String keyword; 
(...) 

public String getKeywordO { 
return keyword; 

} 

} 

Pour afficher 1' attribut keyword de ce managed bean, les pages utilisent 
l'expression #{catal og . keyword}. Le prefixe catal og fait reference a l'alias 
defini dans le fichier faces-config .xml. Ainsi, #{catalog. keyword} equi- 
vaut a invoquer Catal ogCont roller. getKeywordO. 

Declaration de l'alias dans le faces-config.xml 

<managed-bean> 

<managed-bean-name>catal og</managed-bean-name> 

<managed-bean-class> 

com . yaps . pets to re . jsf .Catal ogControl 1 er 

</managed-bean-cl ass> 
</managed-bean> 

La navigation entre pages 

Autre element pris en compte par JSF, la navigation entre les pages de 
l'application web. A l'aide de regies de navigation (navigation rule) 
decrites dans le fichier f aces-conf i g . xml , JSF va determiner en fonction 
de la page courante quelle est la page suivante. Une regie de navigation 
s'ecrit de cette maniere : 

Exemple de regie de navigation definie dans le faces-config.xml 

<navi gati on- rul e> 

<f rom-vi ew-i d>/ showaccount . j sp</f rom-vi ew-i d> Q 
<navi gati on-case> 



<f i-om-outcome>updateaccount</f rom-outcome> © 

<to-vi ew-i d>/ updateaccount . j sp</to-vi ew-i d> 0 

</ navi gati on-case> 
</navi gati on- rul e> 

Cette regie se lit de la facon suivante : « si je suis sur la page 
showaccount. jsp O et q ue ^ a c ^ de navigation est updateaccount©, 
alors je me rends a la page updateaccount. jsp Q ». La cle de navigation 
est la chaine de caracteres retournee par une methode du managed bean 
(les methodes retournent toutes une String). 

Cle de navigation retournee par une methode 

public class AccountController { 

public String doUpdateAccount() { 
C ■ ■) 

return "updateaccount"; 0 

} 

} 

II est aussi possible d'utiliser des expressions regulieres dans la definition des 
regies de navigation pour inclure un plus grand nombre de cas en une seule 
regie. L'exemple ci-apres definit une regie qui permet a partir de n'importe 
quelle page Q d'aller vers mai n . j sp 0 si la cle de navigation est mai n 0. 

Exemple de regie de navigation avec expression reguliere 

<navi gati on- rul e> 

<f rom-vi ew-i d>*</f rom-vi ew-i d> Q 
<navi gati on-case> 

<f rom-outcome>main</f rom-outcome> 0 

<to- vi ew-i d>/ mai n . j sp</ to-vi ew- i d> 0 

</ navi gati on-case> 
</navi gati on- rul e> 

Deux composants JSF declenchent des actions de navigation : un clic sur 
un bouton (balise commandButton ) ou un lien hypertexte (commandLink). 
Lorsque l'utilisateur clique sur Fun ou 1' autre, une cle de navigation 
(outcome) est renvoyee. Cette cle peut etre statique, en dur dans le code 
de la page JSP, ou dynamique, calculee par une EL. 

Navigation statique 

On appelle navigation statique un enchainement entre deux pages qui 
sera toujours le meme. Un clic sur un bouton ou sur un lien hypertexte 



s 



< ... et pour cette cle de navigation... 



< ... on se rend sur cette page. 



i I A partir de n'importe quelle page... 



< ... et pour cette cle de navigation... 



< ... on se rend sur cette page. 
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declenchera toujours la meme destination. Pour illustrer ce propos, 
l'exemple suivant affiche un lien hypertexte avec une action ayant 
comme valeur updateaccount. 

Exemple de navigation statique 

<h : commandLi nk acti on="updateaccount"> 

<h :outputText value="Edit Your Account Information"/> 
</h : commandLi nk> 

Lorsque l'utilisateur clique sur le lien HTML, la cle de navigation 
updateaccount est renvoyee au gestionnaire de navigation de JSF qui va 
rechercher une regie applicable (definie dans le fichier faces - 
conf i g . xml ) et determiner la page suivante a afficher. 

Navigation dynamique 

Dans le cas de la navigation dynamique, la cle de navigation est 
inconnue au moment ou la page est ecrite. C'est done le managed bean 
qui va retourner cette cle via l'appel de l'une de ses methodes. Dans 
l'exemple suivant, la valeur de Faction n'est pas connue. On utilise le lan- 
gage d'expression pour appeler la methode doUpdateAccount du 
managed bean account : 

Exemple de navigation dynamique 

<h : commandLi nk acti on="#{account . doUpdateAccount} "> 

<h :outputText value="Edit Your Account Information"/> 
</h : commandLi nk> 

La valeur de retour de Faction doit etre de type Stri ng, et doit etre refe- 
rencee par une regie de navigation. 

Le managed bean calcule la cle de navigation 

public class AccountControll er { 
public String doUpdateAccount () { 



if (...) 

return "success"; 
el se 

return "failure"; 



JSF Cle de navigation a null 



} 



Les methodes des managed beans doivent 
retourner une cle de navigation de type Stri ng. 
Cette cle doit correspondre a une regie de naviga- 
tion definie dans le fichier faces- 
conf i g . xml . Cette valeur peut aussi etre egale 
a null . Ce cas provoque le reaffichage de la page 
courante. 



} 



La valeur de la cle de navigation varie en fonction du resultat de la 
methode doUpdateAccount (ici "success" ou "failure"). La navigation 
qui en resulte est done variable (dynamique) et l'utilisateur sera redirige 
soit vers une page, soit vers une autre. Bien sur, il faudra declarer ces 
nouvelles regies dans le fichier f aces-conf i g . xml . 
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Si 
-t 

Comment developper une application web J 
avec JSF 

Nous venons de definir de nombreux concepts. II est temps de les assem- 
bler pour comprendre comment creer une application web. Prenons 
l'exemple de la recherche des articles. Dans le cas d'utilisation 
« Rechercher un article » du premier chapitre, 1' application web doit pou- 
voir afficher la liste des articles en se basant sur une chaine de caracteres 
saisie par un internaute. Void le fonctionnement general (figure 7-6). 

La chaine de caracteres est saisie dans une balise inputText. Lorsque 
l'internaute clique sur le bouton Search (commandButton), la methode 
doSearch du managed bean CatalogControl ler est invoquee Q. Celui-ci 
delegue le traitement a l'EJB stateless CatalogBean qui lui retourne une 
liste d'entities Item ©. Grace au fichier faces-config.xml, la navigation 
se fait vers la page searchresult. jsp © qui affiche la liste dans une 
balise dataTabl e Q. 



public class CatalogController { 
private String keyword; 
private List<ltem> items; 

public String doSearchO { 
items = catalogBean.searchltems(keyword); 
return "items.found"; 

} 

} 



Search 



<h:inputText value- '#{catalog.keyword}7> 
<h:commandButton action="#{catalog. doSearch}" 
value="Search"/> 




faces- con fig .xm I 



<faces-config> 
<managed-bean> 
<managed-bean-name>catalog</managed-bean-name> 
<managed-bean-class>CatalogController</managed-bean-class> 
<managed-bean-scope>session</managed-bean-scope> 
</managed-bean> 
<navigation-rule> 
<from-vi ew-id>*</from-vi ew-id> 
<navigation-case> 
<from-outcome>items.found</from-outcome> 
<to-view-id>/searchresult.jsp</to-view-id> 
</navigation-case> 
</navigation-rule> 
sfares-rnrifiq! 



searchresult.jsp 



«stateless» 
CatalogBean S 

searchltems(keyword) 




hA yaps P«t Storal 
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UM *• — IMI 









<h:dataTable value="#{catalog.items}"> 



Figure 7-6 Recherche d'articles 
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Affiche une zone de saisie. 



Le bouton intitule "Search" declenche une 
action. 

WEB HTTP, un protocole sans memoire 

Rappelons que le protocole HTTP est non connecte, 
c'est-a-dire qu'il ne garde aucune information con- 
cernant I'appelant entre deux requetes. La session 
HTTP (classe HttpSession) est le seul moyen qui 
permet de s'affranchir de ce probleme en mainte- 
nant, au fil des pages accedees par I'internaute, 
une transmission des donnees, le tout pour une 
periode limitee : la duree de vie de la session. 



Alias utilise pour invoquer le managed bean. 



La classe du managed bean. 



Managed bean. 



La reference de I'EJB est injectee. 



Les attributs sont accessibles dans les pages via 
le langage d'expression. Par exemple : 
#{catalog. keyword}. 



Methode recherchant les articles. 



Passe la chaine de caracteres a I'EJB. 



Alias utilise pour la navigation. 



Voyons maintenant en detail comment ces enchainements se font. Tout 
d'abord, concentrons-nous sur la saisie de la chaine de caracteres et l'appel 
au managed bean. Le code ci-apres affiche une zone de saisie Q et un 
bouton 0. Lorsqu'on clique sur le bouton, Taction catalog. doSearch est 
invoquee (attribut action de la balise commandButton). 

Extrait de la JSP permettant la saisie de la chaine de caracteres 

<h:inputText val ue="#{catalog. keyword} "/> Q 

<h: commandButton action="#{catalog. doSearch}" 0 

value="Search"/> 

Le suffrxe catalog Q 0 que vous voyez dans cet extrait de code, fait refe- 
rence au managed bean CatalogCont roller 0. Cet alias 0 se fait par le 
fichier de configuration f aces-conf i g . xml . JSF cree une instance de la classe 
com. yaps. petstore. jsf .CatalogController 0 qu'il nomme catalog 0. 
La portee de cet objet est sessi on 0, c'est-a-dire que le managed bean et ses 
attributs pourront etre utilises tout au long de la session de l'utilisateur. 

Extrait du faces-config.xml declarant le managed bean 

<managed-bean> 

<managed-bean-name>catalog</managed-bean-name> 0 

<managed-bean-class> 

com . yaps . petstore .jsf. Catal ogControl 1 er 0 

</managed-bean-cl ass> 

<managed-bean-scope>session</managed-bean-scope> 0 
</managed-bean> 

Lorsque revaluation de l'expression #{catalog. doSearch} 0 se fait, la 
methode doSearch 0 du managed bean est invoquee. La zone de saisie 
0, quant a elle, est mappee avec l'attribut keyword 0. Ainsi, lorsqu'on 
saisit une chaine de caracteres et que Ton clique sur le bouton, la valeur 
est stockee dans la variable keyword, et la methode doSearch est invoquee. 

Extrait du managed bean CatalogController 

public class CatalogController 

@E]B 

private CatalogLocal catalogBean; 0 
private String keyword; 0 
private List<Item> items; 0 

public String doSearch() { 0 

items = catalogBean. searchltems (keyword) ; © 
return "items . found" 0 



} 



} 
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La methode doSearch Q appelle l'EJB stateless CatalogBean au travers de 
son interface locale CatalogLocal © en lui passant la chaine de caracteres 
keyword en parametre ©. Le resultat de la methode searchltems, qui est 
une liste d'entities Item, est alors stocke dans l'attribut items© du 
managed bean. 

Les traitements sont maintenant termines et la methode retourne la cle 
de navigation "items. found" ©. Le fichier faces-config.xml fait coin- 
cider cette cle de navigation © © avec la page searchresult. jsp © qui 
affichera la liste des articles. 

Extrait du faces-config.xml declarant la navigation 

<navi gati on- rul e> 

<f rom-vi ew-i d>*</f rom-vi ew-i d> 
<navi gati on-case> 

<f rom-outcome>i terns. found</f rom-outcome> © 

<to-vi ew-i d>/searchresul t . jsp</to-vi ew-i d> © 

</ navi gati on-case> 
</navigation-rule> 

Le controleur de JSF se charge d'appeler la page searchresult. jsp. 
Celle-ci n'a plus qua iterer © la liste des articles contenus dans l'attribut 
items © du managed bean et en afficher les informations ©. 

Extrait de la page searchresult.jsp affichant la liste des articles 

<h:dataTable value="#{cata"log. items}" var="item"> © 

<h : col umn> 

<h : outputText val ue="#{i tern. name} "/> © 
</h : col umn> 

<h : col umn> 

<h : outputText val ue="#{i tern . product . category . name} "/> 
<h : outputText val ue="#{i tern. product. name} "/> © 

</h : col umn> 

<h : col umn> 

<h : outputText val ue="#{item.unitCost}"/> © 
</h : col umn> 

</h:dataTable> 



< A partir de n'importe quelle page, on applique 
cette regie de navigation. 



< Cle de navigation. 

< | Page de destination. 

JSF Le controleur FacesServlet 

Comme vous pouvez le voir dans cet exemple, 
nous ne manipulons pas directement la 
FacesServlet. La servlet est deployee dans le 
conteneur et intercepte les requetes HTTP, sans 
que nous ayons a interagir avec. 



< Itere la liste d'articles sous forme de tableau. 

< I Affiche le nom de I'article dans une colonne. 



< Le langage devaluation permet d'obtenir les 
attributs des objets lies : 

i tern . get Product () . getCatego ry () 
.getName(). 

< Affiche le prix de I'article. 
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Retour d'experience Developper une application web 

Developper une application web n'est pas chose facile. Comme nous 
I'avons vu en introduction, les specifications ont du se succeder pour 
aboutir a JSF : les sen/lets ont laisse place aux JSP qui ont du s'enri- 
chir de bibliotheques de balises JSTL avant la venue de JSF. Meme si 
JSF federe ces specifications, il est tout de meme necessaire de con- 
naTtre plusieurs API et langages (HTML, Java). De plus, la glue (le 
lien) entre toutes ces technologies se fait par fichier XML et par I'uti- 
lisation de langages d'expressions (EL, UEL). La navigation entre 
pages est aussi un element sensible d'une application web et peut 
s'averer complexe pour une application de grande envergure. Sans 
parler de tous les problemes auxquels doit faire face le developpeur 
(protocole HTTP sans etat, bouton retour des navigateurs...). 



L'objectif de ce livre est de se concentrer uniquement sur Java EE 5, 
ce qui est deja un vaste programme. J'ai done sciemment laisse de 
cote tout framework Open Source qui serait venu rajouter un niveau 
de complexite supplemental a la lecture de ce livre. Ceci dit, je me 
dois de vous parler de JBoss Seam. 

JBoss Seam (futur Web Beans, JSR n° 299) est un framework de deve- 
loppement d'applications web qui unifie et integre JSF et les EJB3, 
entre autres. II a ete pense pour eliminer la complexite inherente aux 
applications web, et pour enrichir certaines lacunes liees au protocole 
HTTP. JBoss Seam offre de nombreuses facilites pour le developpe- 
ment d'applications et se presente de plus en plus comme une alter- 
native aux developpements web classiques. 

► http://www.j boss. co m/p rod ucts/sea m 

► http://www.jcp.org/en/jsr/detail?id=299 



[.'application web YAPS Pet Store 

L'application web YAPS Pet Store permet aux internautes de visualiser 
le catalogue et de rechercher des articles. L'internaute peut aussi se con- 
necter en se creant un compte et devenir ainsi client de la societe. II peut 
alors mettre a jour les donnees de son compte. 



Decorateurs 



Graph Cascading Style Sheet 

L'application utilise le fichier petstore . ess 
pour definir tous les aspects graphiques (couleurs, 
polices de caracteres, etc.). 



Avant de nous concentrer sur les fonctionnalites de l'application web, 
regardons son aspect graphique. Toutes les pages sont construites de la 
meme maniere et utilisent les memes elements, e'est-a-dire (figure 7-7) : 

• un en-tete (header, jspf) qui affiche le logo et le nom de la societe 
ainsi que des liens pour se connecter et se deconnecter du site ; 

• sur la gauche, une barre de navigation (navigation, jspf) liste toutes 
les categories des produits ; 

• un bas de page (footer, jspf) oil se trouvent les logos des technolo- 
gies utilisees (Java, GlassFish et Derby). 

Au lieu de dupliquer ces elements sur toutes les pages, on les inclut a 
l'aide de la directive i ncl ude des JSP. Ci-apres le patron d'une page qui 
nous montre comment inclure ces differents elements Q. La partie spe- 
cifique est contenue dans le corps de chaque page Q. 
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9 YAPS PetStore • Mozilla Firefox 



Fichier Edition Affidiage H'storique Marque-pages Outils ? ' [G] » 



YAPS Pet Store 



Yet Another Pet Store 



Birds 

Cats 

Dogs 

Fish 

Reptiles 



navigation.jspf 



The YAPS Pet Store Demo is a 
fictional sample application. 



search 



Sign cn 



header.jspf 




footer.jspf 
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t\ Derby 



Figure 7-7 

En-tete, menu 
et pied de page 



Extrait d'une page JSP 

<f:view> Q 

<div id="header"> 

<%@ include fi1e="common/header. jspf" %> 0 

</di v> 

<div id="sidebar"> 

<%@ include fi1e="common/navigation. jspf" %> 0 

</di v> 

<div id="body"> 

Corps de la page 0 
</di v> 

<div i d="footer"> 

<%@ include fi1e="common/footer. jspf" %> 0 
</di v> 
</f:view> 0 

La page principale est englobee dans une balise <f : vi ew> 0 alors que les 
fragments (header.jspf, menu.jspf et footer.jspf) doivent etre 
englobes dans une balise <f : subvi ew> 0. 
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Extrait de la page footer.jspf 

<f:subview> Q 

<h :outputText value="The YAPS Pet Store Demo is a fictional 
sample application."/> 

<img border="0" src="images/java.gif" alt="Java"/> 

<img border="0" src="images/glassfish.gif" al t="Gl assFi sh"/> 

<img border="0" src="images/derby.gif" al t="Derby"/> 

</f:subview> Q 



La visualisation du catalogue 

La visualisation du catalogue et la recherche d'articles sont detaillees 
dans les cas d'utilisation « Visualiser les articles du catalogue » et 
« Rechercher un article ». Un internaute peut visualiser le contenu du 
catalogue des animaux domestiques. II peut aussi utiliser le mecanisme 
de recherche qui lui permet de saisir une chaine de caracteres et lui 
retourne une liste d'articles appropries. 



Remarque Simplification du code 

Pour que les lignes de code qui suivent soient plus 
faciles a lire, certaines simplifications ont ete 
faites. La gestion des exceptions, I'affichage des 
messages d'erreurs ou tout simplement les traces 
(API de logging) ne seront pas developpes. 



Figure 7-8 

Diagramme du CatalogController 
et de ses dependances 



Le managed bean CatalogController 

Le managed bean CatalogController permet de faire toutes les actions 
concernant le catalogue. II fait le lien entre les pages JSP et l'EJB state- 
less CatalogBean qui manipule les donnees de Implication via les enti- 
ties (Category, Product et Item). Le diagramme de classes ci-apres 
montre ces relations (figure 7-8). 




keyvrord : String 
|-category : Category 
|-product : Product 

item : Item 

products : List<Product> 

items : List<ltem> 



doFindProductsr.) : String 
+':ioFindlteMisi j Stung 
l+cloFinclltemi; i : string 
+doSeardnO : String 




Extrait du CatalogController 



La reference de l'EJB est injectee dans I'attribut 
catalogBean. 



public class CatalogController 
@EDB 

private CatalogLocal catalogBean; 
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private String keyword; 
private Category category; 
private Product product; 
private Item item; 
private Li st<Product> products; 
private List<Item> items; 
public String doFindProductsO { 

category=catal ogBean . f i ndCategory( 

getParamId("categoryId")) ; 

products = category. getProducts() ; 

return "products. di spl ayed" ; 

} 

public String doFindltemsO { 

product = catalogBean.findProduct(getParamId("productId")) ; 
items = product. getltems () ; 
return "items. displayed"; 

} 

public String doFindltemO { 

item = catalogBean.findItem(getParamId("itemId")) ; 
return "item. displayed" ; 



public String doSearch() { 

items = catal ogBean . searchltems (keyword) ; 
return "items . found" ; 

} 

// Getters & setters des attributs 

} 

Vous remarquerez a plusieurs reprises l'appel a la methode getParamld. 
Celle-ci permet de recuperer un parametre passe par la page JSP. Par 
exemple, lorsqu'on clique sur un lien hypertexte et que Ton veut passer 
un parametre au managed bean, on utilise la balise <f:param>. Dans 
l'exemple suivant, on affecte la valeur 5 au parametre catagoryld. 

Lien hypertexte utilisant la balise <f:param> 

<h : commandLi nk acti on="#{catal og . doFi ndProducts}"> 

<h:outputText val ue="Bi rds"/> 

<f:param name="categoryId" value="5"/> 
</h : commandLi nk> 

Lorsqu'on clique sur ce lien, la methode doFi ndProducts du managed 
bean est invoquee. On peut ensuite recuperer ce parametre grace a la 
methode getParamld. 

Le managed bean recupere la valeur de ce parametre 

public String doFindProductsO { 

catego ry=catal ogBean. findCategory (getParamld ("categoryld")) ; 

products = category. getProducts() ; 
return "products . di spl ayed" ; 
} 
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Ces attributs sont manipules par les pages JSP 
via le langage d'expression (exemple : 
#{catalog. keyword}) 



Cette methode retourne les produits d'une cate- 
gorie. 



< Cette methode retourne les articles d'un produit. 



Pour un identifiant donne, cette methode 
retourne un article. 



A partir d'une chaine de caracteres (keyword), 
cette methode retourne une liste d'articles. 



JSF Le contexte 



Le controleur FacesServlet cree un objet 
FacesContext qui contient les informations 
necessaires a I'execution d'une requete utilisateur, 
c'est-a-dire les objets Servl etContext, 
Servl etRequest et Servl etResponse 
qui sont fournis par le conteneur web. 



La methode getParamld utilise le contexte JSF (FacesContext) pour 
recuperer les parametres passes a la requete HTTP 
(getRequestParameterMap). Ces parametres sont stockes dans une map 
sous la forme cle/valeur. II suffit ensuite de recuperer le parametre qui 
nous interesse (map.get(param)). 

La methode getParamld 

protected Long getParamld (St ri ng param) { 

FacesContext context = FacesContext. getCurrentlnstanceO ; 
Map<String, String> map = 

context . get External Context () . getRequestParameterMap () ; 
String result = map. get (param) ; 
return Long. valueOf (result ); 

} 



Remarque La recherche d'articles 

La recherche d'articles a ete developpee dans le 
paragraphe « Comment developper une applica- 
tion web avec JSF ». Nous ne I'aborderons done 
pas ici. 



A partir de n'importe quelle page (puisque cha- 
que page contient le menu de navigation), si on 
rencontre la cle de navigation 
products. displayed, la page des pro- 
duits est affichee. 



Les pages web 

La visualisation du catalogue utilise trois pages : 

• affichage des produits d'une categorie (showproducts. jsp) ; 

• affichage des articles d'un produit (shown terns .jsp); 

• detail d'un produit (shown terns, jsp). 

La liste des categories (« chat », « chien »...) est contenue dans le menu de 
gauche de chaque page, les rendant ainsi accessibles a travers tout le site. 

La navigation 

La navigation entre les pages est assez intuitive puisqu'elle suit la 
demarche des clients (figure 7-9). Pour acheter un animal, on com- 
mence par choisir la categorie Q (« je voudrais acheter un chien ») puis 
le produit © (« un caniche ») et enfin l'article lui-meme © (« un male 
adulte »). En face de chaque article, on affiche une image representant 
l'animal, son nom, sa description ainsi que son prix. Comme le client 
peut vouloir acheter plusieurs articles, le menu de gauche lui permet a 
tout moment de naviguer dans les categories. 

La navigation entre ces pages est definie dans le fichier faces - 
confi g . xml . 

Extrait du faces-config.xml concernant la navigation du catalogue 

<navigation-rule> 

<f rom-vi ew-i d>*</f rom-vi ew-i d> 
<navi gati on-case> 

<f rom-outcome>products .displayed</f rom-outcome> © 
<to-vi ew-i d>/ showproducts . j sp</to-vi ew-i d> 
</navi gati on-case> 
</navi gati on-rul e> 
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<navi gati on- rul e> 

<f rom-vi ew-id>/showproducts . jsp</f rom-vi ew-id> 
<navi gati on-case> 

<f rom-outcome>i terns . di spl ayed</f rom-outcome> Q 
<to-vi ew-i d>/showi terns . j sp</to-vi ew-i d> 
</ navi gati on-case> 
</navi gati on- rul e> 

<navi gati on- rul e> 

<f rom-vi ew-i d>/ shown terns . j sp</f rom-vi ew-i d> 
<navi gati on-case> 

<f rom-outcome>i tem . di spl ayed</f rom-outcome> © 
<to-vi ew-i d>/ shown tem . j sp</to-vi ew-i d> 
</navi gati on-case> 
</navigation-ru1e> 



De la page des produits, on se dirige vers la page 
des articles. 



A partir de la liste des articles, on navigue vers la 
page affichant le detail d'un produit. 



main.jsp 



showproducts.jsp 



& YAPS^Pet Store 


1 


^ YAPS Pet Store — 


■Ml 

Ml 




Mp 












showitems.jsp 

Figure 7-9 Navigation entre les pages du catalogue 



showitem.jsp 
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La page d'affichage des produits 

En cliquant sur une categorie, la page show/products, jsp affiche la liste 
de ses produits (figure 7-10). 



Figure 7-10 

La page showproducts.jsp 
affiche les produits 
d'une categorie. 



O YAPS PetSto 



Fichier Edition Affichage Historique Marque-pages Outts » |Gl*| :■: 



1 



YAPS Pet Store 



Yet Another Pet Store 



search 



Birds 
Cats 
Dogs 
Fish 

Reptiles 



Products for category : Birds 



Amazon Parrot 

Great companion for up to 75 years 

Finch 

Great stress reliever 



The YAPS Pet Store Demo is a 
fictional sample application. 



Extrait de la page showproducts.jsp 



Cette page utilise les bibliotheques de balises 
JSF. 



Titre de la page avec le nom de la categorie. 



Les eventuels messages d'erreurs sont affiches. ► 



Itere la liste des produits 



<%@ taglib uri="http://java. sun.com/jsf/core" prefix="f" %> 
<%@ taglib uri="http://java. sun.com/jsf/html" prefix="h" %> 

<f : vi ew> 

<h2>Products for category : 

<h : outputText val ue="#{cata1 og . category . name} "/> 

</h2> 

<h:messages layout="table" styleClass="error"/> 
<h : form> 

<h:dataTable value="#{catalog. products}" var="product"> 
<h : col umn> 
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<h : commandLi nk action="#{cata"log.doFindItems}"> 
<h : outputText val ue="#{product . name} "/> 
<f:param name="productId" val ue="#{product . id}"/> 

</h : commandLi nk> 

<br/> 

<h : outputText val ue="#{product . descri pti on}"/> 
</h : col umn> 
</h:dataTab1e> 
</h : form> 
</f:view> 

La page d'affichage des articles 

Un fois la liste des produits affichee, on peut cliquer sur un produit pour 
en connaitre les articles (figure 7-11). 



Affiche le nom du produit sous forme de lien. 
Lorsqu'on clique sur ce lien, la methode 
doFindltems du managed bean est appelee 
en lui passant I'identifiant du produit comme 
parametre (methode getParamld). 



Remarque Simplification du code 

Pour en simplifier la lecture, la totalite du code des 
pages n'est pas detaillee. Retrouvez le code source 
complet de I'application a I'adresse : 
► http://www.antoniogoncalves.org 



£> YAPS PetStore - Items - Mozilla Firefox 



Fichier Edition Affichage Historique Marque-pages Outls ? |G| - 



\zmm 



icalves • 



YAPS Pet Store 



Yet Another Pet Store 



bearch 



Sign on 



Birds 
Cats 
Dogs 
Fish 

Reptiles 



Items for product : Amazon Parrot 



Female Adult 120.0 $ 
Male Adult 120.0 $ 



The YAPS Pet Store Demo is a 
fictional sample application. 




Figure 7-11 

La page showitems.jsp 
affiche les articles 
d'un produit. 
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Titre de la page. 



Itere la liste des articles. 



Affiche le nom de I'article sous forme de lien. 
Cliquer sur le lien invoque la methode 
doFindltem qui retournera I'article identifie 
par #{i tern. id}. 



Affiche le prix unitaire de I'article dans une 
colonne. 



Web Packager des images 

Chaque animal domestique est represents par une 
image. Comme nous le verrons par la suite, celles- 
ci sont packagees avec I'application (JSP, CSS...) et 
accessibles sous le repertoire images. 



Extrait de la page showitems.jsp 

<h2>Items for product : 

<h : outputText val ue="#{catal og . product . name}"/> 
</h2> 

<h :messages 1 ayout="tabl e" styl eCl ass="error"/> 
<h : form> 

<h:dataTable val ue="#{catalog. i terns}" var="item"> 
<h : col umn> 

<h : command Li nk acti on="#{catal og . doFi ndltem} "> 
<h : outputText val ue="#{item. name}"/> 
<f:param name="itemld" value="#{item.id}"/> 

</h : commandLi nk> 
</h : col umn> 

<h : col umn> 

<h:outputText value="#{item.unitCost}"/> $ 
</h : col umn> 

</h : dataTable> 
</h : form> 

La page de detail de I'article 

Cette page permet d'afficher le detail de I'article selectionne, c'est-a-dire 
son nom, son prix et une image (figure 7-12). 



Figure 7-12 

La page showitem.jsp 
affiche le detail d'un article. 



Lbtanque "o^c^ce; Out* > |G] - 



YAPS Pet Store 

Yet Another Pet Store 



search 



Sign on 



Birds 
Cats 
Dogs 
Fish 

Keptiles 



Female Adult 




Unit Cost; 120.0 $ 



The YAK Pet Wore Demo k i) 
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Extrait de la page showitem.jsp 



<h2> 

<h : outputText val ue="#{catal og . i tern . name}"/> 
</h2> 

<h :messages 1 ayout="tabl e" styleClass="error"/> 
<h : form> 

<h:panelGrid columns="2"> 
<h : col umn> 

<h : g raphi clmage u rl =" i mages/#{cata1 og . i tern . i magePath} "/> 

</h : col umn> 

<h : col umn> 

<h:outputText value="Unit Cost:"/> 

<h:outputText value="#{cata"log.item.unitCost}"/> $ 

</h : col umn> 

</h: panel Crid> 
</h : form> 



On dessine un tableau grace a la balise 
panelCrid. 



Dans la premiere colonne, on affiche I'image de 
I'animal. Les images sont stockees dans le sous- 
repertoire images. 



Prix unitaire. 



La gestion du compte par les clients 

La gestion du compte client est detaillee dans les cas d'utilisation « Se 
connecter et se deconnecter », « Se creer un compte » et « Consulter et 
modifier son compte ». L'internaute peut se creer un profil en se choisis- 
sant un login et un mot de passe. Ensuite, en se connectant a Implica- 
tion, il peut acceder a son profil et le mettre a jour. 

Le managed bean AccountController 

La gestion du compte client se fait via le managed bean 
AccountController. Celui-ci invoque l'EJB stateless CustomerBean qui 
manipule les donnees du client (entities Customer et Address). Le dia- 
gramme de classes suivant nous montre ces interactions (figure 7-13). 



isf 

(oom :: yaps: :petstore) 



«control» 
AccountController 



-login : String 
password : String 
passvw>rd2 : String 
-customer : Customer 



♦doSignlnQ: String 
+doCreateNevwAccount() : String 
+doCreateCustonier() : String 
+doUpdateAccount(): String 
+doSignOfl() : String 



customer 
(com : : yaps: : pet store: : stateless) 




entity 
(com::yaps::pet store) 




Figure 7-13 

Diagramme du AccountController 
et de ses dependances 
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[.'injection de I'interface locale de I'EJB est reali- 
see a I'aide de I'annotation @EJ B. 



Attributs et entities manipules par le managed 
bean. 



A partir d'un login et d'un mot de passe, cette 
methode permet d'identifier un client. 



Cette methode cree un client. L'internaute saisit 
ses informations dans un formulaire, ces don- 
nees sont mappees sur les entities Customer 
et Address du managed bean, pour ensuite 
etre passees a I'EJB. 



Mise a jour du compte client. 



Cette methode deconnecte I'utilisateur du site. 
Pour cela, elle utilise le contexte JSF 
(FacesContext) pour recuperer la session 
HTTP et I'invalider. 



Extrait du AccountController 

public class AccountController 
@EDB 

private CustomerLocal customerBean ; 

private String login; 

private String password; 

private String password2; 

private Customer customer = new Customer(); 

private Address homeAddress = new Addressf); 

public String doSignlnO { 

customer = customerBean. authenticate(login, password); 
homeAddress = customer . getHomeAddress() ; 
return "customer. signed. in" ; 

} 

public String doCreateCustomer () { 

customer = customerBean . createCustomer(customer , 

homeAddress) ; 

homeAddress = customer . getHomeAddressO ; 
return "customer .created" ; 

} 

public String doUpdateAccount() { 

customer = customerBean . updateCustomer(customer , 

homeAddress) ; 

homeAddress = customer . getHomeAddressO ; 
return "account . updated" ; 

} 

public String doSignOffO { 

FacesContext fc = FacesContext . getCurrentlnstanceO ; 
HttpSession session = (HttpSession) 

fc.getExternalContextO .getSession(false) ; 
session.invalidatef) ; 
return "main"; 

} 

// Getters & setters des attributs 

} 



Les pages web 

La gestion du compte client peut se decliner en deux parties : 

• connexion au site (signon.jsp) et creation d'un compte client 
(createaccount. jsp) ; 

• affichage des informations du client (showaccount. jsp) et possibilite 
de les mettre a jour (updateaccount. jsp). 
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La plupart de ces actions sont accessibles par des liens hypertextes con- 
tenus dans l'en-tete (header, jspf) de chaque page. 



La navigation 

Lorsque le client arrive sur le site, il peut soit visualiser le catalogue, soit 
se connecter. Pour cela, il peut cliquer sur le lien Sign On de l'en-tete. II 
est alors redirige sur une page lui demandant de saisir son login et son 
mot de passe (figure 7-14). Deux cas de figures sont possibles : soit l'uti- 
lisateur possede deja un compte et le systeme le redirige vers la page 
d'accueil, soit il veut s'en creer un et le site lui propose de renseigner ses 
informations Q. 

Une fois connecte, le client peut a tout moment consulter son compte en 
cli quant sur le lien Account de l'en-tete. A partir de cette page, il peut 
egalement modifier ses informations ©. Le lien Sign Off lui permet de se 
deconnecter. 



signon.is 



LL 



I YAPS Pet Store 



createaccount.jsp 



l YAPS Pet Store 



li«tMI«Wn>l »0»I»ti 



^ YAPS^Pet Store 










tut 

[ M mi HIT 1*1—11 











showaccount.jsp 

Figure 7-14 Navigation entre les pages du compte client 



I YAPS Pet Store 



updateaccount.jsp 



A partir des liens places dans I'en-tete, le client 
peut se connecter au site, se deconnecter ou affi- 
cher les informations de son compte. 



Lorsque les donnees du compte client sont affi- 
chees, on peut les mettre a jour. 



Une fois les donnees du compte mises a jour, on 
les reaffiche. 



Le client saisit son login et mot de passe. S'il est 
connu du systeme, il se connecte et la page prin- 
cipal est affichee. 



Si, lors de la connexion, le client n'est pas 
reconnu par le systeme, on lui affiche un formu- 
laire pour qu'il se cree un compte. 



La navigation entre les pages du compte client est definie dans le fichier 
f aces-conf i g . xml . 

Extrait du faces-config.xml concernant la navigation pour le compte client 

<navigation-rule> 

<f rom-vi ew-i d>*</f rom-vi ew-i d> 
<navi gati on-case> 

<f rom-outcome>signon</f rom-outcome> 

<to-vi ew-i d>/ signon . j sp</to-vi ew-i d> 
</navi gati on-case> 
<navi gati on-case> 

<f rom-outcome>signof f</f rom-outcome> 

<to-vi ew-i d>/signof f . jsp</to-vi ew-i d> 
</navi gati on-case> 
<navi gati on-case> 

<f rom-outcome>showaccount</f rom-outcome> 

<to-vi ew-i d>/ showaccount . j sp</to-vi ew-i d> 
</navi gati on-case> 
</navi gati on-rul e> 

<navigation-rule> 

<f rom-vi ew-i d>/showaccount . jsp</f rom-vi ew-id> 
<navi gati on-case> 

<f rom-outcome>updateaccount</f rom-outcome> 
<to-vi ew-i d>/updateaccount . j sp</to-vi ew-i d> 
</navi gati on-case> 
</navi gati on-rul e> 

<navigation-rule> 

<f rom-vi ew-i d>/updateaccount . j sp</f rom-vi ew-i d> 
<navi gati on-case> 

<f rom-outcome>account.updated</f rom-outcome> 
<to-vi ew-i d>/showaccount . jsp</to-vi ew-i d> 
</navi gati on-case> 
</navi gati on-rul e> 

<navigation-rule> 

<f rom-vi ew-i d>/signon . j sp</f rom-vi ew-i d> 
<navi gati on-case> 

<from-outcome>customer. signed. in</f rom-outcome> 
<to-vi ew-i d>/mai n . j sp</to-vi ew-i d> 
</navi gati on-case> 
</navi gati on-rul e> 

<navigation-rule> 

<f rom-vi ew-i d>/ signon . j sp</f rom-vi ew-i d> 
<navi gati on-case> 

<f rom-outcome>create . a . new . account</f rom-outcome> 
<to-vi ew-i d>/createaccount . j sp</to-vi ew-i d> 
</navi gati on-case> 
</navi gati on-rul e> 
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L'en-tete 



Presente dans la partie haute de toutes les pages, l'en-tete propose des 
liens permettant aux clients de se connecter, de se deconnecter ou de 
consulter son compte. 

Extrait du fragment de page header.jspf 

<c:choose> 

<c:when test="${empty sessionScope.account}"> 

<h : commandLi nk acti on="signon"> 
<h:outputText value="Sign on"/> 
</h : commandLi nk> 
</c :when> 

<c : otherwi se> 

<h : commandLi nk acti on="showaccount"> 

<h : outputText val ue="Account"/> 
</h : commandLi nk> 

<h : commandLi nk acti on="#{account . doSignOf f}"> 

<h: outputText va"lue="Sign off"/> 
</h : commandLi nk> 

</c:otherwise> 
</c:choose> 

La page de login 

Cette page est decoupee en deux parties (figure 7-15). Les clients qui 
ont deja un compte saisissent leur login et mot de passe dans la partie 
gauche. Pour les autres, ils peuvent se choisir un login et saisir deux fois 
le meme mot de passe. Ils seront ensuite rediriges vers un formulaire leur 
demandant de completer les informations de leur compte client. 



Balise Core JSP permettant de faire un test. 



Si le managed bean account ne se trouve pas 
dans la session HTTP, cela signifie que le client 
n'est pas connecte. On affiche alors le lien Sign 
On pour lui permettre de se connecter. 



Sinon, le client est deja authentifie. 



Ce lien utilise la navigation statique pour acce- 
der a la page du compte client. 

Lien permettant de se deconnecter. 



Retour d'experience S'authentifier a un site 

Dans notre application, nous n'utilisons aucun mecanisme sophistique 
pour gerer I'authentif ication. En effet, on teste juste si le managed bean 
account se trouve dans la session HTTP ou non. Tout site qui se respecte 
doit avoir une politique de securite a toute epreuve. En standard, la spe- 
cification des servlets introduit un mecanisme d'authentification 
(j_username, j_password, j_securi ty_check). S'il ne vous convient pas, 
vous pouvez aussi utiliser JAAS (Java Authentication and Authorization Ser- 
vice) ou un outil de Single Sign On (SSO). 

► https://opensso.dev.java.net/ 

► http://java.sun.com/products/jaas/ 
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Figure 7-15 

La page signon.jsp 
permet I'authentification. 



Fichier Edition Affichage H istorique Marque^ges Que ls ? 



"A YAPS Pet Store 

Yet Another Pet Store 


|| Search | 


Sign on 



Birds 
Cats 
Dogs 
Fish 

Reptiles 



Sign In 



Are you a 



Yes. 


No. I would like to sign up for an account. 


Login: □ 


Login: □ 






Password: 


Password: 






| Sign In | 


Password (Repeat): | 




| Create new account | 



The YAPS Pet Store Demo is a 
fictional sample application. 



Java 



<f^q Derby 



Les clients qui ont deja un compte saisissent leur 
login et leur mot de passe avant de se connecter. 



Les clients qui n'ont pas de compte, doivent sai- 
sir un login et deux fois le meme mot de passe. 



Extrait de la page signon.jsp 

Are you a returning customer ? 
Login : 

<h : i nputText val ue="#{account . 1 ogi n}" 

maxlength="10" size="12"/> 

Password : 

<h : i nputSecret val ue="#{account .password}" 

maxlength="10" size="12"/> 

<h:commandButton va"lue="Sign In" action="#{account.doSignIn}" 

type="submit"/> 

No. I would like to sign up for an account. 
Logi n : 

<h : i nputText val ue="#{account . customer . 1 ogi n} " 

maxlength="10" size="12"/> 

Password: 

<h : i nputSecret val ue="#{account . customer . password} " 

maxl ength="10" size="12"/> 
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Password (Repeat): 

<h : i nputSecret val ue="#{account . password2}" 

maxlength="10" size="12"/> 

<h:commandButton val ue="Create new account" 

acti on="#{account . doCreateNewAccount}" type="submi t"/> 



Le formulaire de saisie 

Cette page permet aux clients n'ayant pas de compte de s'en creer un en 
saisissant leurs informations (identite et adresse de domiciliation) 
(figure 7-16). 



Create Custome 



Fidiier Edition Affidiage Historique Marque-pages OuSIs > i[Gl* 



. Ill, 



o 



-A 



YAPS Pet Store 



Yet Another Pet Store 



Birds 
Cats 
Dogs 
Fish 

Reptiles 



bearch 



Account Cart Sign off 



Create Your Account 



Personal information 



Login : 
"Firstname : 
"Lastname : 
Email : 
Telephone : 

Date of birth (dd.MM.yyyy): 



antonio 



Antonio 



Goncalves 



3oncalves@gmail.com 



12 456 789 789 



"Streetl : 32, Broad Street 
Street2 : | 

"City : |San Francisco 
State : | 
"Zipcode : |4567 
"Country : |USA 



Figure 7-16 

createaccount.jsp affiche 
un formulaire de creation 
de compte. 
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Identite du client. 



Tableau de deux colonnes. 

Login, nom, prenom, adresse e-mail et numero 
de telephone. Remarquez que les donnees du 
formulaire sont directement affectees a I'entity 
customer 
(#{account. customer. login}. . .). 



La date de naissance est convertie au format jj/ 
mm/aaaa. 



Adresse du client. 



Les informations de I'adresse sont affectees a 
I'entity Address. 



Une fois le formulaire saisi le client clique sur le 
bouton Submi t pour se creer un compte. 



Extrait de la page createaccount.jsp 

<h2>Create Your Account</h2> 

<h:messages 1 ayout="tabl e" styl eCl ass="error"/> 
<h : form> 

<h3>Personal i nformation</h3> 

<h:panelCrid columns="2"> 

<h:outputText value="Login :"/> 

<h : i nputText val ue="#{account . customer .login}" 

readonly="true"/> 

<h:outputText val ue="*Fi rstname :"/> 

<h : i nputText val ue="#{account . customer . f i rstname} "/> 

<h : outputText val ue="*Lastname :"/> 

<h : i nputText val ue="#{account . customer . 1 astname} "/> 

<h : outputText value="Email :"/> 

<h : i nputText val ue="#{account . customer . email }"/> 

<h: outputText val ue="Tel ephone :"/> 

<h : i nputText val ue="#{account . customer . tel ephone} "/> 

<h : outputText value="Date of birth (dd.MM.yyyy) : "/> 
<h : i nputText val ue="#{account . customer . dateOf Bi rth} "> 

<f : convertDateTime patte rn="dd . MM . yyyy"/> 
</h : i nputText> 

</h:panelCrid> 
<h3>Address</h3> 
<h:panelCrid columns="2"> 



<h: outputText value 
<h:i nputText value= 
<h : outputText value= 
<h:i nputText value= 
<h: outputText valuer 
<h:i nputText value= 
<h: outputText value; 
<h:i nputText value= 
<h : outputText valuer 
<h:i nputText value= 
<h : outputText value= 
<h:i nputText value; 

</h:panelCrid> 



"*Streetl :"/> 
#{account . homeAddress , 

Street2 :"/> 
#{account . homeAddress . 
"*City :"/> 
#{account . homeAddress . 
"State :"/> 

#{account . homeAddress . 

"*Zipcode :"/> 
#{account . homeAddress . 

*Country :"/> 
#{account . homeAddress . 



streetl}"/> 
street2}"/> 
city}"/> 
state} "/> 
zipcode}"/> 
country} "/> 



<h : commandButton val ue=" Submi t" 

acti on="#{account . doCreateCustomer} " type=" submi t "/> 

</h : form> 

L'affichage du compte client 

Lorsque le client est connecte, le lien Account s'affiche dans l'en-tete. En 
cliquant sur ce lien, l'utilisateur est redirige vers la page showaccount . j sp 
qui affiche les donnees du client en lecture seule (figure 7-17). Pour les 
mettre a jour, il suffit de cliquer sur le lien Edit Your Account Information. 



206 



Fichier Edition Affidiage 



Marque -pages 



YAPS Pet Store 

^fj^ Yet Another Pet Store 


1 Search | 


Account Cart Sian off 



Birds 
Cats 
Dogs 
Fish 

Reptiles 



Your Account Information 



Personal information 



Firstname : 
Lastname : 
Email : 
Telephone : 
Date of birth (dd.MM.yyyy): 29.05.1971 
Age : 35 



Antonio 
Goncalves 

antonio.goncalves@gmail.com 
12 456 789 789 



Streetl : 32, Broad Street 
Street2 : 

City : San Francisco 
State : 

Zipcode : 4567 
Country : USA 



Edit Your Account Information 



The YAPS Pet Store Demo is a 
fictional sample application. 




q Derby 



Figure 7-17 

La page showaccount.jsp 
affiche les informations 
du client. 



Extrait de la page showaccountjsp 



<h2>Your Account Informati on</h2> 

<h:messages 1 ayout="tabl e" styleQass="error"/> 

<h : form> 

<h3>Personal informati on</h3> 
<h:panelCrid col umns="2"> 

<h : outputText val ue="Fi rstname :"/> 

<h : outputText val ue="#{account . customer . f i rstname}"/> 

<h: outputText val ue=" Lastname :"/> 

<h : outputText val ue="#{account . customer . 1 astname}"/> 

<h : outputText val ue="Emai 1 :"/> 

<h : outputText val ue="#{account . customer . email }"/> 
<h : outputText val ue="Tel ephone :"/> 

<h : outputText val ue="#{account . customer . tel ephone}"/> 



Section identite du client. 



Les balises outputText permettent d'afficher 
en lecture seule les attributs de I'entity 
Customer. 
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Remarquez I'acces a la variable age qui est cal- 
culee par I'entity a partir de la date de naissance. 



Adresse de domiciliation. 



Affiche les attributs de I'entity Address. 



Le lien hypertexte utilise la navigation statique. 



Identite du client. 



Adresse de domiciliation du client. 



Pour mettre a jour le compte client, le die sur le 
bouton invoque la methode 
doUpdateAccount du managed bean. 



<h : outputText value="Date of birth (dd.MM.yyyy) : "/> 
<h : outputText val ue="#{account . customer . dateOf Bi rth} "> 

<f : convertDateTime pattern="dd .MM. yyyy"/> 
</h :outputText> 

<h: outputText value="Age :"/> 

<h : outputText val ue="#{account . customer . age} "/> 

</h:panelGrid> 
<h3>Address</h3> 
<h:panelGrid col umns="2"> 



<h: outputText value= 
<h: outputText value= 
<h: outputText value= 
<h: outputText value= 
<h : outputText value= 
<h : outputText value= 
<h : outputText value= 
<h : outputText value= 
<h : outputText value= 
<h: outputText value= 
<h: outputText value= 
<h : outputText value= 

</h:panelGrid> 



"Streetl : 
"#{account 
"Street2 : 
"#{account 
"City :"/> 
"#{account 
"State :"/> 
"#{account 
"Zipcode : 
"#{account 
"Country : 
"#{account 



/> 

homeAddress , 
homeAddress . 
homeAddress , 

homeAddress , 

/> 

homeAddress , 

/> 

homeAddress . 



streetl}"/> 

street2}"/> 

city}"/> 

state}"/> 

zipcode}"/> 

country} "/> 



<h : commandLi nk acti on="updateaccount"> 

<h:outputText value="Edit Your Account Information"/> 
</h : commandLi nk> 

</h : form> 



La mise a jour du compte client 

Cette page affiche un formulaire pre-rempli des donnees du client et 
permet de les modifier (figure 7-18). Le code est presque identique a 
celui de la page createaccount. jsp, nous n'en detaillerons done que 
quelques lignes. 

Extrait de la page updateaccount.jsp 

Personal information 

(...) 

Address 

(...) 

<h : commandButton val ue="Submi t" 

acti on="#{account . doUpdateAccount}" type="submi t"/> 
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s 

Si 
■S 



Rdiier Edition Affichage Historique 



Google 
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"Zipcode : |4567 



-Country : |USA 



Submit | 



Figure 7-18 

updateaccount.jsp 
permet de modifier le 
compte client. 



Gestion des erreurs 

Les sources des managed beans et des pages ont ete simplifiees pour en 
faciliter la lecture et la comprehension. Dans le code que nous avons vu 
precedemment, la gestion des erreurs a ete supprimee. 

Le comportement souhaite est qu'en cas d'exception, la page en cours se 
rafraichisse en affichant le message d'erreur en rouge. Pour cela, nous 
avons besoin de deux elements. Le premier est l'utilisation de la balise 
<h:messages> dans chaque page. En effet, cette balise permet d'afficher 
les erreurs detectees par le bean manage. Le deuxieme est le code du 
managed bean qui permet de gerer cette fonctionnalite. 

Le code ci-apres nous montre comment un bean manage intercepte des 
exceptions et peut changer la navigation entre pages. 
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Cette variable contient la cle de navigation. 



£ Bloc try. 



Le traitement se fait sans exception, la cle de 
navigation est affectee. 



En cas d'exception, on rajoute un message au 
contexte JSF. 



Retourne la valeur null ou 
customer, created. 

Rajoute un message dans le contexte de JSF. 



Architecture La validation des donnees 

Dans la gestion des exceptions que nous decrivons 
precedemment, le systeme renvoie une exception 
(Val i dati onExcepti on) en signalant que le 
nom de famille est obligatoire. Si vous vous 
reportez au chapitre 4, Objets persistants, vous 
verrez que cette exception est levee dans une 
methode annotee OPrePersist de I'entity 
Customer. 



Exemple de methode traitant les erreurs 

public String doCreateCustomerO { 
String navigateTo = null; 0 
try { 

customer = customerBean . createCustomer(customer , 0 

homeAddress) ; 

homeAddress = customer . getHomeAddressO ; 

navigateTo = "customer . created" ; 0 
} catch (Exception e) { 

addMessage(e) ; O 



return navigateTo; 0 



} 



private void addMessage(Stri ng message) { 0 

FacesContext context = FacesContext.getCurrentlnstanceO ; 
context . addMessage(null , new FacesMessage( 

FacesMessage . SEVERITY_WARN , message, null)); 

} 

Chaque methode declare une variable de type String navigateTo 0. 
Celle-ci contient la cle de navigation qui va etre retournee par la 
methode 0 et qui sera interpretee par le controleur JSF pour afficher la 
page a suivre. Cette methode effectue des traitements 0, et si aucune 
exception n'est levee, la cle de navigation est affectee 0. Par contre, en 
cas d'exception, la variable navigateTo reste egale a null, et un message 
d'erreur est rajoute au contexte JSF ©. La valeur null est alors 
retournee ©, ce qui entraine le reaffichage de la page en cours avec un 
message d'erreur. 

La methode privee addMessage 0 permet de rajouter des messages dans le 
contexte de JSF (FacesContext .addMessage ()). Labalise <h :messages> 0 
se charge alors d'afficher les messages contenus dans ce contexte. 

Extrait de la page createaccount.jsp avec affichage des erreurs 

<f :view> 
(...) 

<h2>Create Your Account</h2> 
(...) 

<h : messages/> 0 
(...) 

<h3>Personal information</h3> 
(...) 
</f : vi ew> 
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L'image ci-apres nous montre le cas ou le client veut valider son formu- 
laire alors qu'il n'a pas saisi son nom, champ defini comme 
obligatoire (figure 7-19). La page se reaffiche avec le message Invalid 
last name. 
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Paquetages et repertoires de l'interface web 

Les managed beans AccountController et CatalogController sont 
places dans le paquetage com. yaps. petstore. jsf. 

L'application ne comporte plus seulement des classes Java, mais aussi des 
pages JSP, une feuille de style et des images. Tous ces elements se situent 
dans le repertoire resources, au meme niveau que le repertoire sre qui 
contient les classes Java. Les JSP ainsi que la feuille de style 
(petstore. ess) sont a la racine, les decorateurs (en-tete, bas de page et 
barre de navigation) sont dans le sous-repertoire common, et les images 
des animaux dans images. 

Le descripteur de deploiement web (web.xml) et la configuration JSF 
(faces-config.xml) se trouvent dans le repertoire WEB-INF. 



Figure 7-19 

Affichage d'un message d'erreur 
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Figure 7-20 Elements de l'application web 
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Architecture 



Le diagramme de composants suivant nous montre comment s'inserent les 
managed beans et l'application web (figure 7-21). La plomberie interne 
de JSF, comme le controleur, n'est pas detaillee dans ce diagramme. Le 
navigateur est done represente comme dialoguant directement avec les 
managed beans. 

Le client Swing utilise les interfaces distantes des stateless beans, alors 
que les managed beans invoque les methodes des interfaces locales. La 
couche des traitements manipule les donnees persistantes au travers 
d'entities. Quant a la couche de presentation, elle en affiche le contenu 
dans des pages JSP. 



« entity* > 


1CL* 


«entity>> 




«entity» 


Category 




Product 


4^ 


Rem 




Figure 7-21 Le client web dans I 'architecture globale de l'application 



Executer l'application 



Web Serveur et conteneur 



Pour mettre a disposition des fichiers (pages HTML 
statiques, images, video...) et gerer les requetes 
HTTP, on doit utiliser un serveur web. Pour exe- 
cuter les servlets, les JSP, les taglibs JSTL ou JSF, il 
faut un conteneur web. GlassFish fournit toutes 
ces fonctionnalites. 



Dans le precedent chapitre Execution de l'application, nous avons deploye 
les entity et les stateless beans dans le conteneur d'EJB et execute l'inter- 
face Swing des employes. Desormais, il est egalement necessaire de 
deployer l'application web et de l'utiliser a partir d'un navigateur. 

La compilation des classes se fait toujours par 1' execution de la tache Ant 
yaps-compile. Le packaging de l'application (yaps-build) est enrichi 
pour pouvoir rajouter une application web (on park souvent de webapp) 
al'archive entreprise (.ear). 
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Packager 

Les applications web sont packagees dans des fichiers d'archive, appeles 
archives web, et qui portent une extension .war (Web ARchive). Ces 
archives permettent de regrouper tous les elements d'une application web, 
que ce soit cote traitements (managed bean JSF, servlets, classes Java...) ou 
cote presentation (pages HTML, JSP, images, son, etc.). Cette extension du 
format JAR, specialement dediee aux applications web, a ete introduite dans 
les specifications 2.2 des servlets. C'est un format independant de toute 
plate-forme et exploitable par tous les conteneurs web qui respectent cette 
version de specification. 

La partie web de l'application YAPS Pet Store sera contenue dans le 
fichier petstore.war. A la racine de ce fichier, on trouve nos pages JSP, 
la feuille de style petstore.css et les images des animaux (sous-reper- 
toire images). Les classes compilees des managed bean JSF doivent obli- 
gatoirement se trouver dans le sous-repertoire WEB-INF/cl asses. Ce 
repertoire est automatiquement ajoute par le conteneur au CLASSPATH 
lors du deploiement de l'application. 

Pour que le conteneur web puisse interpreter le fichier petstore.war et 
deployer le controleur JSF (FacesServlet), il lui faut un descripteur. 
C'est le role du fichier web . xml , qui doit obligatoirement etre present 
dans le repertoire WEB-INF. On trouvera egalement a cet endroit le fichier 
de configuration faces-conf i g . xml . 

La tache yaps-build packagera l'application entiere dans le fichier 
petstore.ear. Celui-ci comporte : 

• l'application web contenue dans le fichier petstore.war avec ses 
fichiers de description (web. xml et faces-config.xml) ; 

• le fichier des EJB stateless (stateless, jar) ; 

• les entities (entity, jar) et les classes utilitaires (utility, jar) acces- 
sibles depuis le sous-repertoire 1 i b. 

Deployer l'application et acceder au site 

Pour deployer l'application, GlassFish doit etre lance (ant -f admi n . xml 
start-domain) ainsi que la base de donnees Derby (ant -f admin. xml 
start-db). Utilisez ensuite la tache yaps-deploy qui deploiera l'archive 
petstore.ear et initialisera la base de donnees. Vous n'avez plus qu'a 
prendre le navigateur de votre choix et vous rendre a l'adresse http:// 
local host :8080/petsto re pour commencer a visualiser le catalogue et 
vous creer un compte (figure 7-23). 



Rappel Les fichiers d'archive 

II existe plusieurs types de fichiers d'archive pour 
packager une application Java EE : 

• les .jar (Java ARchive) pour les classes Java 
et les EJB ; 

• les .war (Web ARchive) sont utilises pour les 
applications web (servlet, JSP, JSF, images, 
HTML) ; 

• les .ear (Enterprise ARchive) contiennent les 
fichiers JAR et WAR. 



3] petstore.ear 
£h Blib 

I- 9 utility jar 
L- ^entity jar 

L Eg persistence xml 
^ stateless.jar 
- (Jpetstorewar 

E3 WEB-INF 
I- jJIffaces-config.xml 
L >x] web xml 



Figure 7-22 Contenu du fichier petstore.ear 
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Figure 7-23 

Page d'accueil du site 
YAPS Pet Store 
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The YAPS Pet Store Demo is a 
fictional sample application. 



JWX <St3 Derby 



En resume 

Pour acceder au systeme, les employes utilisent une interface Swing et les 
internautes un navigateur. Ce chapitre vous a presente la panoplie de tech- 
nologies utilisees pour developper une application web. Le modele MVC 
de JSF nous permet de representer graphiquement les donnees contenues 
dans les entities. Ceci est facilite par les managed beans qui deleguent les 
traitements aux EJB stateless. Le principe d'injection, qui facilite cette 
interaction, va etre largement utilise dans les chapitres suivants. 
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Gestion du panier electronique 



Les internautes peuvent desormais gerer leur compte client 

et visualiser le catalogue d'animaux. L'etape suivante consiste 

a autoriser ces clients a acheter des articles en ligne. 

Ce chapitre nous presente la gestion du Caddie electronique, 

ou plus exactement comment aj outer des articles dans 

un panier virtuel et en modifier la quantite. Ce panier 

est implements a l'aide d'un stateful session bean. 



SOMMAIRE 

► Acheter des animaux en ligne 

► Gerer son panier electronique 

► Conserver I'etat dans 
une application web 

► Stateful session bean 

► Cycle de vie des stateful beans 

MOTS-CLES 

► Stateful bean 

► HTTP Session 



Conteneur EJB 




Figure 8-1 

Un client pour un stateful bean 



YAPS Pet Store propose un systeme de Caddie electronique pour les 
clients desirant acheter des animaux en ligne. Une fois authentifie, le 
client consulte le catalogue et peut ajouter des articles dans son panier 
virtuel. II peut en rajouter autant qu'il le desire, en modifier la quantite, 
en supprimer, puis regler ses achats. Lorsque le client valide son panier, 
une commande est automatiquement creee. Ces interactions entre l'uti- 
lisateur et 1' application web doivent etre preservees. Si ce n'etait pas le 
cas, I'application perdrait toute coherence. Imaginez qua chaque ajout 
d'un produit, l'utilisateur doivent s'identifier, pour ensuite s'apercevoir 
que tous les produits ajoutes precedemment aient disparus ! II est done 
necessaire de preserver les interactions en memoire. 

La gestion de l'etat dans une application web est difficile car le protocole 
sur lequel elle se base est intrinsequement sans etat. En effet, HTTP ne 
dispose pas de moyens pour se souvenir des interactions qui auraient pu 
se produire avec l'utilisateur. Le serveur web, avec l'aide du navigateur, 
doit done maintenir les informations entre deux requetes. C'est pour 
cette raison qu'il est necessaire d'utiliser le concept de session (voir cha- 
pitre precedent, Interface web) si le serveur web souhaite garder un sou- 
venir de l'etat conversationnel. 

En plus de la session HTTP, Java EE possede un autre moyen de stocker 
et de gerer cet etat : les EJB stateful. Lapplication YAPS Pet Store utilise 
un stateful session bean pour implementer son panier electronique. 

Retour d'experience Stateful EJB vs HttpSession 

La plate-forme Java EE possede deux technologies lui permettant de 
stocker l'etat d'une application web : les sessions HTTP et les stateful 
session beans. II est parfois difficile de faire le choix entre les deux 
lorsqu'on a des donnees a stocker durant une session utilisateur. Voici 
une regie simple pour les differencier : la session HTTP est plutot utilisee 
pour stocker la logique de presentation alors que le stateful stocke la 
logique metier. De plus, avec le stateful, cet etat est accessible par les 
autres composants et non uniquement par le client web. 



HTTP Session Object vs Stateful EJB 




Stateful session bean 

Par opposition aux stateless beans (sans etat), les stateful session beans (avec 
etat) associent les requetes a un client specifique, unissant client et bean dans 
une relation un a un. Ce type de composant peut aussi fournir un ensemble 
de methodes metier, mais il dispose en plus de la possibilite de conserver des 



donnees entre les differents appels d'un meme client. Une instance est done 
dediee a un client qui sollicite ses services, et ce, tout au long du dialogue 
entre les deux protagonistes. Generalement, les methodes proposees par un 
stateful bean permettent de consulter et de mettre a jour cet etat. 

Dans notre cas, le client veut pouvoir acheter plusieurs animaux domesti- 
ques. II parcourt le catalogue, achete un caniche, puis quelques minutes 
plus tard, decide de le remplacer par un dalmatien, et achete en plus un 
poisson rouge. Tout cela peut prendre plusieurs minutes et a tout moment 
le client peut vouloir consulter le contenu de son panier electronique. Ce 
contenu (l'etat de l'EJB) doit done etre accessible tout au long de cette 
conversation. Les statefuls maintiennent un etat conversationnel, mais ils 
ne sont pas persistants (contrairement aux entities), e'est-a-dire que l'etat 
ne survivrait pas a un arret du serveur, par exemple. 

On peut voir un stateful bean comme une extension de 1' application 
cliente. Les donnees conservees par le bean sont stockees dans des varia- 
bles d'instances et conservees en memoire, tout comme une application 
riche. Dans notre cas, la gestion du panier est propre a un client. Si au 
lieu d'utiliser un client leger nous utilisions une application Swing, la 
gestion du panier se ferait sur le poste client. 

Exemple de stateful bean 

Pour developper un stateful bean, les seuls objets necessaires se resument 
a une classe contenant le code metier et, au minimum, une interface per- 
mettant les appels. Dans l'exemple ci-apres, l'interface locale 
Shoppi ngCartLocal definit une methode pour ajouter un nouvel article 
dans le panier. La classe Shoppi ngCartBean implemente cette interface. 

Interface locale 

©Local O 

public interface Shoppi ngCartLocal { 

void addltem(ltem item); 

Classe du stateless bean 

©Stateful © 0 

public class Shoppi ngCartBean implements Shoppi ngCartLocal { 

private Li st<CartItem> cartltems; © 

public void addltem(ltem item) { 

cartltems. add (new Cartltem(i tern, 1)); 0 

} 

// autres methodes metiers 

} 



Approfondir Stateful EJB 

£3 Rima Patel Sriganesh, Gerald Brose, Micah 
Silverman, Mastering Enterprise 
JavaBeans 3.0, Wiley, 2006 

► http://www.jguru.com/faq/ 
view.jsp?EID=917 
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"i Ce code est tres similaire a celui d'un stateless bean. En fait, les seules 

<v 

I differences resident dans l'utilisation de l'annotation ©Stateful © au lieu 

| de ©Stateless, et dans le fait que les attributs Q conservent leur etat 0 

entre les appels. Les interfaces restent identiques puisqu'elles sont anna- 
's tees par ©Local Q et doivent etre implementees par la classe ©. 

3 

EJB Annoter les interfaces 

En EJB 3.0, il y a deux manieres differentes d'utiliser les annotations 
©Remote et ©Local . 

• L'interface elle-meme est annotee et la classe de I'EJB implemente 
cette interface (c'est la notation utilisee dans ce livre) : 

©Local 

public interface Shoppi ngCartLocal { 
void addltem(ltem item); 

} 

©Stateful 

public class Shoppi ngCartBean implements Shoppi ngCartLocal { 
(...) 

public void addltem(ltem item) { 
(...) 

} 

} 

• L'interface n'est pas annotee, charge a la classe de I'EJB d'utiliser les 
annotations : 

public interface Shoppi ngCartLocal { 
void addltem(ltem item); 

} 

©Stateful 

©Local (Shoppi ngCartLocal .class) 

public class Shoppi ngCartBean implements Shoppi ngCartLocal { 
(...) 

public void addltem(ltem item) { 
(...) 

} 

} 



Comment developper un stateful bean 

Le developpement d'un stateful bean est identique a celui d'un stateless 
(voir chapitre 5, Traitements metier) : il faut une classe ainsi qu'une ou 
deux interfaces. 
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Les interfaces 



Un stateful bean peut avoir une interface distante et/ou locale. Son role 
etant de garder et de gerer un etat, il a tendance a surtout etre utilise 
localement par une application web. Une application Swing, par 
exemple, n'a pas besoin de stateful bean pour gerer son etat, elle peut le 
faire elle-meme. On peut tout de meme utiliser les deux types d'inter- 
faces que Ton annotera avec ©Local et/ou ©Remote. 



Rappel Les interfaces 



Reportez-vous au chapitre 5, Traitements metier, 
ou les interfaces sont expliquees en detail. 



La classe de PEJB 

La classe du bean contient le code metier et implemente les interfaces. La 
nouveaute des stateless beans se caracterise par le fait que Ton peut 
declarer des attributs en etant certain de leur contenu entre chaque appel. 

La classe d'implementation du bean 

©Stateful 0 

public class ShoppingCartBean implements ShoppingCartLocal { Q 

private Li st<CartItem> cartltems; Q 

public void addltem(ltem item) { 

cartltems . add (new Cartltem(i tern , 1)); 

} 

// autres methodes metiers 

} 

Comme vous pouvez le voir, pour distinguer une simple classe Java d'un 
EJB stateful, il suffit d'utiliser l'annotation ©javax.ejb. Stateful Q. La 
classe implemente les methodes de l'interface © et maintient l'etat de sa 
variable cartltems Q. 

Les attributs de l'annotation ©javax.ejb. Stateful sont identiques a 
ceux de ©javax.ejb. Stateless. 

Code de l'annotation @javax.ejb.Stateful 

package javax.ejb; 

@Target(value = {TYPE}) ©Retention (value = RUNTIME) < I Cette annotation s'applique a une classe. 

public ©interface Stateful { 

String name() default ""; < Norn de I'EJB. Par defaut, le nom est celui de la 

classe. 

String mappedName() default ""; < Cet attribut represents le nom donne a I'EJB a 

I'interieur du conteneur. II est specifique a cha- 
que serveur d'applications et peut done ne pas 
etre portable. 

String description() default ""; < Description du stateful session bean. 

} 



Svntaxe Classe EJB 

La classe de I'EJB suit les regies de developpement 
suivantes : 

• elle doit etre annotee par ©Stateful ; 

• elle doit etre publique ; 

• elle ne doit pas etre finale ; 

• elle ne doit pas etre abstraite ; 

• elle ne doit pas definir la methode 
f i nal i ze ; 

• elle doit avoir un constructeur par defaut ; 

• elle doit implementer les methodes de ses inter- 
faces. 
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EJB Stateless vs stateful 



Stateless : pas de donnees internes ; peut etre 
partage entre plusieurs clients; pas de 
passivation ; est stocke dans un pool. 
Stateful : conserve son etat sur une suite 
d'appels ; dedie a un seul client ; pas de pool ; 
utilise la passivation et I'activation. 



Figure 8-2 

Cycle de vie d'un stateful bean 



Le cycle de vie d'un stateful bean 

La grande difference entre le cycle de vie d'un stateful et d'un stateless se 
resume au fait qu'il n'y a pas de pool. Pour les stateless beans, le serveur 
d' applications recupere n'importe quel EJB disponible dans un pool, puis 
lui transmet une requete a traiter. En effet, les stateless n'ayant pas d'etat, 
ils peuvent executer un traitement indifferemment du client appelant. Le 
stateful, lui, appartient a un seul client, ce qui rend l'emploi du pool inu- 
tile. Par contre, lorsqu'il est inutilise pendant un certain temps, le conte- 
neur le supprime de la memoire en le passivant (il serialise alors ses 
donnees). Puis, lorsqu'un traitement doit etre effectue, il le reactive. 

Suivant Implementation du conteneur, le stateful bean a generalement 
une duree de vie (timeout) parametrable. C'est-a-dire que si le client n'y 
accede pas durant une certaine periode, l'EJB est supprime du conteneur. 



©PieDestroy 




Appel d'une method e metier 



//. Activation et passivation 

• Passivation : si l'EJB n'est pas utilise, le conte- 
neur enregistre I'etat du bean en memoire per- 
sistante (disque, base de donnees) et I'elimine 
de la memoire. 

• Activation : le conteneur reactive l'EJB et 
charge son etat depuis la memoire persistante. 
II peut alors etre reutilise et invoque par le 
client. 

Syntaxe Callback 

Une methode annotee par une annotation callback 
respecte les regies suivantes : 

• elle peut etre annotee par une ou plusieurs 
annotations de callback ; 

• elle ne peut lancer que des 
RuntimeException ; 

• elle peut etre public, package, 
protected ou private. 



Letat inexistant signifie que l'EJB n'a pas encore ete instancie et n'existe 
pas en memoire. Au premier appel d'une methode, le cycle de vie s'ini- 
tialise et reste dedie a un seul client. Lorsqu'il est a I'etat pret, le stateful 
bean garde son etat conversationnel avec le client et repond a ses 
requetes. Pendant sa duree de vie, il se peut qu'il ait des moments d'inac- 
tivite. Alors, pour liberer des ressources, le conteneur peut decider de le 
supprimer de la memoire et de le passiver pour une utilisation ulterieure 
(generalement, I'etat de l'EJB est stocke sur disque). II le reactivera (en le 
remettant en memoire) a l'interception d'une nouvelle requete du client. 

Les annotations de callback 

Tout comme les entity et les stateless beans, le passage d'un etat a l'autre 
peut etre intercepte grace a des annotations de callback. II existe quatre 
annotations utilisables par les stateful beans. 

• @javax. annotation . PostConstruct 

• @javax. annotation. PreDestroy 
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• @javax . ejb . PostActi vate 

• @javax . ejb . PrePassi vate 

Apres avoir instancie un stateful bean, le conteneur execute les methodes 
annotees par OPostConstruct. Dans le cas inverse, l'annotation 
OPreDestroy est appelee lorsque le conteneur supprime definitivement 
l'EJB. Deux autres annotations permettent d'intercepter le moment pre- 
cedant une passivation (@PrePassi vate) ou succedant a une activation 
(@PostActi vate). Le developpeur peut utiliser ces annotations pour 
liberer des ressources (par exemple, une connexion a une base ou a une 
file d'attente) avant que la passivation n'ait lieu, et les reinitialiser lors de 
l'activation de l'EJB. 

Stateful bean utilisant des annotations de callback 
©Stateful (name = "Shoppi ngCartSB") 

public class Shoppi ngCartBean implements Shoppi ngCartLocal { 

private Li st<CartItem> cartltems; 
(...) 

@PostConstruct 

public void initialize() { 

cartltems = new ArrayLi st<CartItem>() ; 

} 

} 

@PreDestroy 

public void clear() { 
cartltems = nul 1 ; 

} 



Le stateful bean utilise une liste d'objet. 



L'initialisation de la liste est faite apres I'instan- 
ciation de l'EJB par le conteneur. L'annotation 
OPostConstruct intercepte cet evenement 
et effectue un new sur la liste. 



A la destruction de l'EJB, le conteneur appelle 
cette methode qui affecte la liste d'objet a 
null. 



La gestion du Caddie de YAPS Pet Store 

La gestion du panier est detaillee dans le cas d'utilisation « Acheter des 
articles » du premier chapitre. Un client visualise le catalogue et lorsqu'il 
est interesse par un article, il l'ajoute dans son panier electronique. Le 
Caddie est utilise uniquement par l'application web, il n'existe pas 
d'equivalent dans l'application Swing. 

Le stateful bean 

Le panier est represente par un stateful session bean. II possede un 
attribut de type List qui stocke les articles selectionnes par le client, 
ainsi que leur quantite. Le composant Shoppi ngCart possede plusieurs 
methodes permettant d'agir sur le contenu de cette liste : 

• addltem : rajoute un article dans le Caddie. 

• removeltem : supprime un article du Caddie. 
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• getTotal : retourne le montant total du Caddie. 

• empty : vide le Caddie. 

• getCartltems : retourne le contenu du panier, c'est-a-dire une liste de 
Cartltem. 

Le diagramme suivant nous montre les classes et interfaces impliquees 
dans la gestion du panier electronique (figure 8-3). 



Figure 8-3 

Diagramme de classes du ShoppingCart 



fi 



stateful 
(com::yap s: : petstore) 



«intertace» 
ShoppingCartLocal 



~addltem(item : Item) : void 
removeltem(item : Item ) : void 
getTotal() : Float 
emptyO : void 

g etc artl tern s() : List<Cartltem> 




Interface locale. 



Methodes manipulant le contenu du Caddie 
electronique. 



ShoppingCartLocal 

Les methodes referencees dans l'interface locale sont utilisables par 
Implication web. Elles permettent au client d'aj outer des articles dans le 
panier electronique, de les supprimer, d'obtenir le prix total ou le con- 
tenu du Caddie. Ces actions se font uniquement au travers de l'interface 
locale, il n'y a done pas d'interface distante. 

©Local 

public interface ShoppingCartLocal { 

void addltem(ltem item); 
void removeItem(Item item); 
Float getTotal () ; 
voi d emptyO ; 

List<CartItem> getCartltems () ; 



ShoppingCartBean 

La classe Shoppi ngCartBean implemente l'interface locale en ajoutant du 
code a toutes les methodes. Letat du stateful bean (le contenu du panier) 
est stocke dans une liste d'objets Cartltem. 



Grace a I'annotation, cette classe est identifiee 
comme etant un stateful bean qui se nomme 
Shoppi ngCartSB. 



©Stateful (name = "Shoppi ngCartSB") 
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public class ShoppingCartBean implements ShoppingCartLocal { 

private Li st<CartItem> cartltems; 



< Le bean implements I'interface locale. 

< I Liste des articles contenus dans le panier. 



@PostConstruct 

public void initialize() { 

cartltems = new ArrayLi st<CartItem>() ; 

} 



Apres initialisation de I'EJB par le conteneur, 
cette methode est appelee. Elle permet d'instan- 
cier la liste de Cartltem. 



@PreDestroy 

public void clear() { 
cartltems = nul 1 ; 

} 



Avant de detruire le stateful bean, le conteneur 
appelle cette methode. 



public void addltem(ltem item) { 
boolean itemFound = false; 
for (Cartltem cartltem : cartltems) { 
if (cartltem. getltem() . equal s (i tern)) { 

cartltem. setQuantity(cartItem.getQuantity() + 1) ; 
itemFound = true; 

} 

} 

if (litemFound) 

cartltems. add (new Cartltem(item, 1)); 

} 



Cette methode ajoute un article dans le panier. 
Si I'article est deja dans le panier, on en modifie 
la quantite. 



public void removeItem(Item item) { 
for (Cartltem cartltem : cartltems) { 
if (cartltem. getltem() . equal s (i tern)) { 
cartltems . remove(cartltem) ; 
return ; 

} 

} 



Cette methode supprime un article du panier. 



public Float getTotal () { 

if (cartltems == null | | cartltems . i sEmptyO) 
return Of; 

Float total = Of; 

for (Cartltem cartltem : cartltems) { 
total += (cartltem. getSubTotal ()) ; 

} 

return total ; 



Cette methode additionne le prix de chaque arti- 
cle pour retourner le prix total du panier. 



public void empty () { 
cartltems. clear() ; 

} 



Cette methode vide le panier. 
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Cartltem 



L'objet Cartltem represente un element du panier. En effet, il fait refe- 
rence a l'entity Item (article) ainsi qua la quantite achetee. Le panier 
electronique est constitue d'une liste de Cartltem. 



Simple objet Java sans annotation. 



Reference I'entityltem ainsi que la quantite 
achetee. 



Cette methode retourne le sous-total (prix uni- 
taire d'un article multiplie par sa quantite). 



public class Cartltem 

private Item item; 
private Integer quantity; 

public Float getSubTotal () { 

return item.getUnitCostO * quantity; 

} 

// getters & setters 



com 

6- S/ yaps 

petstore 
client 



entity 

exception 

l-;f 

, stateful 

C "a Cartltem 

ShoppingCartBean 
— I w ShoppingCartLocal 
ffi- [!□ stateless 



Figure 8-4 Sous-paquetage stateful 



Paquetages du stateful bean 

L'interface, la classe du stateful bean ainsi que la classe Cartltem se trou- 
vent dans le paquetage com. yaps. petstore. stateful. 

Retour d'experience Les noms des paquetages 

Vous I'aurez remarque, le nom de nos paquetages se rapporte aux tech- 
nologies utilisees. Ainsi, le paquetage entity comporte tous les entities 
de I'application, stateless tous les stateless session beans, etc. Ce decou- 
page en technologie est interessant pour un apprentissage rapide : un 
simple nom evoque une API ou une specification. Ce modele a done ete 
utilise pour, une fois de plus, simplifier la comprehension de Java EE 5 et 
vous aider a vous reperer rapidement dans le code. 
En revanche, ce decoupage est a proscrire dans un projet. Imaginez que 
vous laissiez les stateless beans pour utiliser de simples Pojo ou que les 
entities se tranforment en classes Hibernate. Vous devriez alors changer 
le nom des paquetages. 

II est preferable de prendre des noms plus generiques tels que business 
(pour la couche de traitements) ou domai n (pour les objets metiers). On 
peut aussi regrouper les classes par domaines plutot que par couches. On 
aurait ainsi un paquetage catal ogue qui comporterait les stateless beans. 



Le managed bean 

Le managed bean Shoppi ngCartControl 1 er fait le lien entre les pages et les 
appels aux composants metier. II comporte toutes les methodes liees a la 
gestion du panier (ajout et suppression d'un article) qu'il delegue au stateful 
bean, et invoque les stateless beans pour connaitre les donnees du catalogue 
ou du client. Le diagramme de classes suivant nous montre ces interactions 
(figure 8-5). 
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«control» 
ShoppingCartController 



creditCard : CreditCard 
customer : Customer 
deli very Address : Address 
ler: Order 



> 



BddltemToCartO: String 

noveltemFromCartQ: String 
jpdateQuantity(): String 
:kout() : String 
fmiOrderO : String 



> 



stateless 

«interface» 
CatalogLocal 



«interface» 
OrderLocal 



> 



«intenace» 
ShoppingCartLocal 



Figure 8-5 

Diagramme du ShoppingCartController 
et de ses dependances 



Extrait du ShoppingCartController 



public class ShoppingCartController { 
@EJB 

private Shoppi ngCartLocal shoppi ngCartBean ; 
@E3B 

private CatalogLocal catalogBean; 
@E3B 

private OrderLocal orderBean; 

private CreditCard creditCard = new Credi tCard() ; 

private Order order; 

private Customer customer; 

private Address del i veryAddress ; 



public String addltemToCartO { 

Item item = catalogBean. fi ndItem(getParamId("itemId")) ; 
shoppi ngCartBean . addltem (i tern) ; 
return "i tern . added" ; 

} 



public String removeltemFromCartO { 

Item item = catalogBean. fi ndItem(getParamId("itemId")) ; 
shoppi ngCartBean. removeItem(i tern) ; 
return nul 1 ; 

} 



public String checkout() { 
return "cart . checked . out" 

} 



Grace a I'annotation @EJB, le conteneur injecte 
les references des interfaces locales des EJB sta- 
teless (CatalogBean et OrderBean) et de 
I'EJB stateful Shoppi ngCardBean. 



Ces attributs sont initialises par le faces- 
conf i g . xml (voir plus bas). lis correspondent 
aux informations du client qui est connecte. 



Cette methode permet d'ajouter un article au 
panier. La page web passe en parametre I'identi- 
fiant de I'article (i temld) au bean qui utilise le 
stateless CatalogBean pour recuperer 
I'entity Item. Cet entity est rajoute dans le 
panier. 

La valeur de retour item. added est utilisee 
pour la navigation (voir le faces- 
config.xml). 



Meme type de traitement que la methode ci-des- 
sus. Notez la valeur de retour null. Celle-ci 
indique a JSF de reafficher la meme page. En 
effet, lorsqu'on supprime un article du panier, 
une redirection est faite sur la page qui en affi- 
che le contenu. 



Lorsque le client a termine ses achats des ani- 
maux et qu'il souhaite valider son panier, il cli- 
que sur le lien Check Out. Aucune action n'est 
effectuee. Seule une redirection vers la pro- 
chaine page est lancee. 
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Le client saisit son adresse de livraison, son ► 
moyen de paiement et valide ses achats. C'est a 
ce moment que le bon de commande est cree 
grace au stateless OrderBean et que le panier 
est vide. 



Cette methode permet d'afficher le prix total du ► 
panier. 



Retourne le contenu du Caddie. ► 



fch E5 Yaps 

— CD classes 
H- resources 
CD common 
£}- Cj images 

- Ti& confirmorder.jsp 

- jif, createaccount.jsp 

- [a) index. jsp 

- jsj) main. jsp 

- js§ orderconfirmed.jsp 

- ess petstore.css 

- ds^ searchresult.jsp 

- isft showaccount.jsp 

- £fj showcart. jsp 

- ds^ showitem.jsp 

- ^ showitems.jsp 

- ^ showproducts.jsp 

- jsj signoff.jsp 

- signon.jsp 

L- 5sri updateaccount.jsp 
src 

ihh EqWeb-inf 

\- ^ffaces-config.xml 
L web, xml 

Figure 8-6 Elements de I'application web 



public String confirmOrderO { 

order = orderBean . createOrder (customer , deli veryAddress , 
creditCard, shoppingCartBean.getCartltemsO) ; 
shoppingCartBean. empty () ; 
return "order . confi rmed" ; 

} 

public Float getTotal () { 

return shoppingCartBean . getTotal () ; 

} 

public List<CartItem> getCartltemsO { 
return shoppingCartBean.getCartltemsO ; 

} 

} 

Les pages web 

L'application web est enrichie de trois pages qui permettent : 

• de consulter et de modifier le contenu du panier (showcart .jsp) ; 

• de saisir l'adresse de livraison et le moyen de paiement 
(confi rmorder. jsp) ; 

• d'obtenir un recapitulatif des achats effectues et d'informer le client 
du numero de bon de commande (orderconfi rmed. jsp). 

Pour utiliser son panier electronique, l'internaute doit au prealable etre 
authentifie. Le menu Add to cart (ajouter au panier) s'affichera alors en 
face de chaque article. Un simple clic permet d'aj outer un article dans le 
panier. L'internaute peut alors en modifier la quantite, ou supprimer un 
article qu'il ne souhaiterait plus. Durant sa session, le client peut, a tout 
moment, visualiser le contenu de son panier en cliquant sur le menu Cart 
situe dans 1'en-tete. 

La navigation 

A partir des pages affichant un article (showi terns, jsp et showitem. jsp), 
il est possible de cliquer sur le lien Add to cart Q pour ajouter un article 
et consulter le contenu du panier (showcart. jsp). Cette page se 
reaffiche 0 lorsque le client supprime un article du Caddie ou qu'il en 
modifie la quantite. Apres validation de son panier (en cliquant sur le 
lien Check Out), le client est dirige vers une page © (confi rmorder. jsp) 
lui demandant de saisir l'adresse de livraison ainsi que son numero de 
carte bancaire. En confirmant, il est redirige Q vers une page recapitu- 
lant le contenu de son panier et l'informant du numero de bon de com- 
mande (orderconfi rmed. jsp) (figure 8-7). 
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Figure 8-7 

Navigation entre les pages 
concernant le panier 
electronique 



Comme nous l'avons vu dans le precedent chapitre, Interface web, la 
navigation est definie dans le fichier faces-config.xml. Void done, au 
format comprehensible par JSF, l'enchainement entre ces pages. 

Extrait du faces-config.xml concernant la navigation 

<navi gati on- rul e> 

<f rom-vi ew-i d>/ shown terns . j sp</f rom-vi ew-i d> 
<navi gati on-case> 

<f rom-outcome>item.added</f rom-outcome> 
<to-vi ew-i d>/ showcart . j sp</to-vi ew-i d> 
</ navi gati on-case> 
</navi gati on- rul e> 

<navi gati on- rul e> 

<f rom-vi ew-i d>/showi tern . j sp</f rom-vi ew-i d> 
<navi gati on-case> 

<from-outcome>item.added</f rom-outcome> 
<to-vi ew-i d>/showcart . jsp</to-vi ew-i d> 
</navi gati on-case> 
</navi gati on- rul e> 

<navi gati on- rul e> 

<f rom-vi ew-i d>/ showcart . j sp</ f rom-vi ew-i d> 
<navi gati on-case> 

<from-outcome>cart .checked. out</from-outcome> 
<to-vi ew-i d>/conf i rmorder . j sp</to-vi ew-i d> 
</navi gati on-case> 
</navi gati on- rul e> 



A partir de la page affichant la liste des articles, 
un die sur Add to cart permet d'ajouter un 
article au panier et d'aller a la page 
showcart . j sp qui en affiche le contenu Q. 



A partir de la page affichant un article, un die 
sur Add to cart permet d'ajouter cet article 
au panier et d'aller a la page showcart . jsp 
qui en affiche le contenu Q- 



Lorsqu'il consulte le contenu de son Caddie et 
qu'il veut le valider, le client clique sur Check 
Out. II est alors redirige vers la page 
confi rmorder qui lui demande de saisir son 
adresse de livraison et son mode de paiement Q. 
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Apres confirmation de I'adresse et du mode de 
paiement, la page de recapitulatif 
orderconfi rmed s'affiche Q. 



<navigation-rule> 

<f rom-vi ew-i d>/conf i rmorder . j sp</f rom-vi ew-i d> 
<navi gati on-case> 

<f rom-outcome>order .conf i rmed</f rom-outcome> 
<to-vi ew-i d>/orderconf i rmed . j sp</to-vi ew-i d> 
</navi gati on-case> 
</navi gati on-rul e> 



Ajouter un article au Caddie 

Lorsque le client est authentifie, et done reconnu par le systeme, il peut 
acheter des articles. Pour cela, les pages showi terns, jsp et showitem. jsp 
sont enrichies d'un lien Add To Cart (figure 8-8). Un simple clic sur ce 
lien et l'article en question est automatiquement ajoute dans le Caddie. 
Le client est alors redirige vers la page showcart. jsp lui permettant de 
consulter l'etat de son Caddie. 



Figure 8-8 

La page showitem.jsp avec le lien Add To Cart 
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YAPS Pet Store 



LfuabJ 
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Extrait de la page showitem.jsp 

<%@ taglib uri="http://java. sun.com/jsp/jstl/core" 
prefi x="c"%> 

<%@ taglib uri="http://java. sun.com/jsf/core" prefix="f" %> 
<%@ taglib uri="http://java. sun.com/jsf/html" prefix="h" %> 
, <f : vi ew> 
<h : form> 
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<h : g raphi clmage u rl = "i mages/#{catal og . i tern . i mage Path} "/> 

<h:outputText value="Unit Cost:"/> 

<h:outputText value="#{catalog.item.unitCost}"/> $ 

<c:if test="${not empty sessionScope. account} "> 

<br/> 

<h : command Li nk action="#{cart .addItemToCart}"> 

<h:outputText va"lue="Add to cart"/> 
<f:param name="i temld" va1ue="#{cata"log.item.id}"/> 
</h : commandLi nk> 
</c : i f > 
</h : form> 
</f :view> 



La page affiche I'image de I'animal domestique 
ainsi que son prix. 



Si le client est connecte (c'est-a-dire que la ses- 
sion HTTP contient I'objet account) ... 



... alors le lien Add To Cart est affiche. Lors- 
que le client clique dessus, la methode 
addltemToCart du managed bean est invo- 
quee. Le numero de I'article est passe en para- 
metre. 



La page de contenu du Caddie 

Cette page permet d'afficher et de modifier le contenu du panier electro- 
nique. Lorsque celui-ci est vide, un message en avertit le client. Sinon, la 
page showcart. jsp s'affiche avec pour chaque article son nom, sa descrip- 
tion, sa quantite, son prix unitaire etle sous-total (prix unitaire x quantite). 
Le montant total du panier est egalement renseigne (figure 8-9). 



Precision Le code des JSP 



Pour que le code des JSP soit plus lisible, certaines 
balises comme <h:co"lumn> ou 
<h : panel Gri d> ont ete supprimees. 
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The YAPS Pet Store Demo is a 
fictional sample application. 
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Figure 8-9 

La page showcart.jsp 
affiche le contenu du panier. 
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Extrait de la page showcart.jsp 



Utilisation de I'Expression Language (EL) pour 
verifier si le panier est vide. 



Si le Caddie n'est pas vide, on affiche son con- 
tent 



Permet d'iterer la liste des articles contenus dans 
le panier. 



Affiche le nom du produit. 



Affiche un lien vers I'article. Notez que I'identi- 
fiant est passe en parametre au managed bean 
(voir I'appel a la methode getParamldO 
pour obtenir la valeur de ce parametre). 



Affiche la ligne « 4 x 1 20 $ = 480 $ », par exem- 
ple. 

Lien pour supprimer I'article du Caddie. 



Affiche le prix total du panier. 



<%@ taglib uri = 
<%@ taglib uri = 

<f : vi ew> 
<c : choose> 



'http://java.sun.com/jsf/core" prefix="f" %> 
'http://java.sun.com/jsf/html" prefix="h" %> 



<c:when test="${empty sessionScope.cart.cartItems}"> 

The Shopping Cart is empty 
</c:when> 

<c:otherwise> 
<h : form> 

<h:dataTable value="#{cart.cartltems}" var="cartltem"> 



<h : outputText val ue="#{cartltem . i tem . product . name} "/> 

<h : command Li nk acti on="#{catal og . doFi ndltem} "> 

<h : outputText val ue="#{cartltem . i tem . name}"/> 
<f:param name="itemld" value="#{cartItem.item.id}"/> 
</h : commandLi nk> 

<h : commandLi nk acti on="#{cart . updateQuanti ty}"> 
<h : outputText val ue="Update"/> 

<f:param name="itemld" value="#{cartItem.item.id}"/> 
</h : commandLi nk> 

<h : i nputText val ue="#{cartltem . quanti ty}"/> 

x <h : outputText value="#{cartItem.item.unitCost}"/> $ 

= <h:outputText value="#{cartItem.subTotal}"/> $ 

<h : commandLi nk acti on="#{cart . removeItemFromCart}"> 
<h : outputText val ue="Remove"/> 

<f:param name="itemld" value="#{cartItem.item.id}"/> 
</h : commandLi nk> 

</h:dataTable> 
Total $ <h: outputText val ue="#{cart . total }"/> 



La page de saisie des donnees de livraison et de paiement 

Lorsque le client valide le contenu du Caddie, il est redirige vers la page 
confimorder. jsp (figure 8-10). Celle-ci est un formulaire compose de 
trois parties : 

• le nom, prenom et adresse e-mail du client sont affiches a titre infor- 
matif en lecture seule ; 

• une zone permettant de saisir l'adresse de livraison. Par defaut, le sys- 
teme affiche l'adresse de domiciliation du client ; 

• une zone pour le mode de paiement, c'est-a-dire numero de carte 
bancaire, type et date d'expiration. 
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YAPS PetStore • Confirm Order - Mozilla Pirefox 
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Figure 8-10 La page confimorder.jsp permet la saisie des informations de livraison. 
Extrait de la page confirmorder.jsp 



<%@ tag "lib uri="http://java. sun.com/jsf/core" prefix= 
<%@ taglib uri="http ://java. sun . com/jsf/html " prefix= 

<f : vi ew> 
<h : form> 

<h3>Personal information</h3> 
<h:outputText val ue="Fi rstname :"/> 
<h : i nputText val ue="#{cart . customer . f i rstname} " 
readonly="true"/> 

<h : outputText val ue="Lastname :"/> 

<h : i nputText val ue="#{cart . customer . 1 astname}" 

readonly="true"/> 
<h : outputText value="Email :"/> 
<h : i nputText val ue="#{cart . customer . emai 1 }" 

readonly="true"/> 



'f" %> 
'h" %> 



Affiche le nom, prenom et adresse e-mail du 
client en lecture seule. 
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Le formulaire de saisie de I'adresse de livraison 
est pre-initialise par I'adresse de domiciliation 
du client (voir fichier f aces-conf i g . xml ). 



Formulaire de saisie du moyen de paiement. 



Le type de carte de credit est presente dans une 
combo-box. 



Extrait du fichier faces-config.xml 



Le managed bean AccountControll er a 
comme alias account. 



Le managed bean ShoppingCartController 
a comme alias cart. 



<h3>Delivery Address</h3> 
<h:outputText val ue="*Streetl :"/> 

<h : i nputText val ue="#{cart . del i veryAddress . streetl}"/> 
<h :outputText val ue="Street2 :"/> 

<h : i nputText val ue="#{cart . del i veryAddress . street2}"/> 
<h :outputText val ue=" -City :"/> 

<h : i nputText val ue="#{cart . del i veryAddress . ci ty}"/> 
<h :outputText value="State :"/> 

<h : i nputText val ue="#{cart. deli veryAddress . state} "/> 
<h : outputText val ue="*Zi pcode :"/> 

<h : i nputText val ue="#{cart . del i veryAddress . zi pcode}"/> 
<h : outputText val ue=" -Country :"/> 

<h : i nputText val ue="#{cart . del i veryAddress . country}"/> 
<h3>Credit Card</h3> 

<h :outputText value="*Credit card number :"/> 

<h : i nputText val ue="#{cart . credi tCard . credi tCardNumber} "/> 

<h : outputText val ue=" -Type :"/> 

<h : sel ectOneMenu val ue="#{cart . credi tCard .credi tCardType} "> 
<f : sel ectltem itemValue="visa" itemLabel="Visa"/> 
<f :selectltem i temVal ue="vi sa_gol d" i temLabel="Vi sa Cold"/> 
<f: sel ectltem i temVal ue="master" iteml_abel="Master Card"/> 
<f : sel ectltem i temVal ue="ameri can" 

itemLabel="American Express"/> 

</h : sel ectOneMenu> 

<h : outputText val ue="*Expi ry date (MM/YY):"/> 

<h : i nputText val ue="#{cart . credi tCard . credi tCardExpDate}"/> 

</h : form> 

</f : vi ew>n 

Lorsque cette page s'affiche, elle est pre-initialisee par les donnees du 
client ainsi que son adresse de domiciliation. Ces informations sont 
gerees et manipulees par le managed bean AccountCont roller et non 
ShoppingCartController. JSF a la possibilite d'initialiser les attributs 
dun managed bean a partir d'attributs d'un autre managed bean. Cette 
action se fait de maniere declarative dans le fichier faces- 
config.xml .Dans notre cas, on veut initialiser l'attribut customer et 
del i veryAddress du ShoppingCartController avec les valeurs des attri- 
buts customer et homeAddress du AccountControll er. 



<managed-bean> 

<managed-bean-name>account</managed-bean-name> 
<managed-bean-class> 

com . yaps . petstore . j sf . AccountCont rol 1 er 
</managed-bean-cl ass> 

<managed-bean-scope>session</managed-bean-scope> 
</managed-bean> 

<managed-bean> 

<managed-bean-name>cart</managed-bean-name> 
<managed-bean-class> 

com . yaps . petstore . j sf . Shoppi ngCartCont rol 1 e r 
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</managed-bean-cl ass> 

<managed-bean-scope>session</managed-bean-scope> 

<managed-property> 

<property-name>cus tome r</p rope rty-name> 
<val ue>#{account . customer}</val ue> 

</managed-property> 

<managed-property> 

<property-name>del i veryAdd res s</p rope rty-name> 
<val ue>#{account . homeAddress}</val ue> 

</managed-property> 

</managed-bean> 



L'attribut customer du managed bean 
Shoppi ngCartControl 1 er est initialise 
avec #{account. customer} (c'est-a-dire 
l'attribut customer du managed bean ayant 
comme alias account). 



L'adresse de livraison est initialised avec 
I'adresse de domiciliation. 



La page recapitulative 

L'adresse et le mode de paiement saisis, le client est redirige vers une 
page recapitulant ses achats (figure 8-11). Cette page l'lnforme du 
numero de bon de commande ainsi que de la reception imminente d'un 
e-mail (voir chapitre 10, Traitements asynchrones). 



Telecharger Le code de I'application 

Retrouvez le code de I'application YAPS Pet Store 
sur le site : 

► http://www.antoniogoncalves.org 



□chef edition AffioSage IJstorique Marque-pages Outib ? [G]- 



:::• 



YAPS Pet Store 

Yet Another Pet Store 



Birds 
Cats 
Dogs 
rish 

Reptiles 



I search 



Account Cart 



Your Order is Complete : 103 



Your order id is 1UJ 
Amazon Parrot 



l-emale Adult 



4 X 120.0 S - 480.0 $ 

5 X 100.0 $ - 500.0 t 
1X20.0$ -20.0$ 

S^o^alePuppy 2 * 22 - 0 * -«•«* 



Female Adult 
Rattlesnake 

Male Adult 



Total $ 1044.0 



You will receive 
Thank you for 



an email confirming your order 
with the YAPS Pet Store 



Top YAK Ppr Srnrp Opmn « a 
/fLt/orid/ stfrnofc dpp/rLdtffu. 



Figure 8-11 

La page orderconfirmed.jsp 
affiche le recapitulatif. 



Le code de cette page est tres similaire a celui de showcart . jsp. II ne sera 
done pas decrit ici. 
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Architecture 

L'architecture se voit enrichie d'un nouveau managed bean 
(ShoppingCartController). Celui-ci a pour tlche d'invoquer les 
methodes du stateful bean ShoppingCartBean lorsque l'utilisateur sou- 
haite acceder a son panier electronique. Le stateful bean n' expose qu'une 
interface locale et utilise une liste de Pojo (Cartltem) pour stacker le 
contenu du Caddie. 




Executer I'application 



[Ji petstore.ear 
Blib 

I- 9 utility jar 
L % entity jar 

m persistence xml 
, stateless.jar 
- ^slaletuljar 
CJ, pelstore war 

t C9 WEB-INF 

tiS (aces-config.xml 
$1 web-xml 



Figure 8-13 Contenu du fichier petstore.ear 



Pour executer I'application, il suffit d'utiliser les memes taches Ant yaps- 
clean, yaps-build et yaps-deploy qui compileront, packageront les classes 
et deploieront les fichiers archives dans GlassFish. Le stateful session bean 
Shoppi ngCartBean est deploye dans un fichier JAR autonome : 
stateful .jar. 

L'application a deployer sur le serveur est packagee dans le fichier 
petstore.ear qui contient : 

• les EJB stateless (stateless.jar) ; 

• l'EJB stateful (stateful .jar) ; 
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• les entities (entity, jar) et les classes utilitaires (utility, jar) acces- 
sibles depuis le sous-repertoire lib; 

• l'application web contenue dans le fichier petstore.war avec ses des- 
cripteurs de deploiement (web.xml et faces-config.xml). 

Vous pouvez maintenant utiliser l'application web pour acheter des ani- 
maux domestiques, et l'interface Swing pour consulter les bons de com- 
mande qui sont crees (figure 8-14). 



Remarque Stateful dans I'arbre JNDI 

Apres le deploiement, si vous consultez I'arbre 
JNDI a partir de la console GlassFish, vous noterez 
que le stateful bean n'y apparait pas. En effet, 
celui-ci n'ayant qu'une interface locale, GlassFish 
ne I'ajoute pas dans son annuaire. Le stateful bean 
ne peut done pas etre recherche (lookup) par un 
client distant. 



I 



File Customer Catalog Order look&Feel 



I Lists all Hie ortlers 

ID I Date 




Identifier 1 

Order data 06/06/2006 



Lost Name Jobs 
Date of birth 30/11/1864 



street 1 1 54 star Boulevard 
Street 2 

City Son Froncioco 
State 



WC 

country USA 




Order - 1 (Read only) 



ID 


Item 


Quantity 


Sub-total 


I 


Spotted 


1 


1211 


2 


Spotless 


1 


liU 


3 


Female Puppy 


5 


60 0 


4 


Spotted Female Puppy 


10 


3200 





Delivery Address 

Street! 1 54 Star Doulevard 

Street 2 

City San Francisco 
State WC 
5455 
UOA 



Total 404 0 

Credit card 



Number 1234 5648 7890 
Type visa 
Expiry uVlte 09/08 



Figure 8-14 Affichage du detail d'un bon de commande 



En resume 

Dans ce chapitre, nous avons enrichi l'application web existante en y 
ajoutant un panier electronique. Cette nouvelle fonctionnalite permet 
aux clients d'acheter en ligne des animaux domestiques. Pour cela, nous 
avons utilise les stateful session beans de Java EE 5. Les managed beans 
de JSF font l'intermediaire entre la representation graphique du panier 
(JSP) et son contenu (EJB stateful). 
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Q YAPS PelSlure - Hems - Muzilla Fifefux 



Fichier Edtion Affidw Hstorioue Maraue-oaaes Outils ? [Cl* 



YAPS Pet Store 



Yet Another Pet Store 



I Search | 

Armnnt Cart q/on nff 



Birds 
Cats 
Dogs 
Fish 

Reptiles 



Your order id is 103 

Amazon Parrot 

Femdle Adull 



Your Order is Complete : 103 



4 X 120.0 S = 480.0 S 

5 X 100.0 S - 500.0 $ 
1 X 20.0 % ^ 

2x: 




Echanges B2B 



SOMMAIRE 

Lorsqu'un client valide ses achats, les donnees de sa carte 
bancaire doivent etre verifiees. Une fois le bon de commande 
cree, le transporteur doit etre averti pour livrer les animaux 
a leurs proprietaires. Ces echanges avec les societes partenaires 
BarkBank et PetEx se font au travers de services web. 
Ce chapitre nous presente ces technologies, puis un exemple 
de developpement et de test de services web. 

MOTS-CLES 

► Services web 

► Soap 

► WSDL 

► JAX-WS 

► JAXB 



► Systemes externes 
et interoperability 

► Validation de la carte bancaire 

► Avertir le transporteur 

► Les services web 

► Technologies autour 
des services web 

► Generation des artefacts 

► Deployer et tester 
un service web 



B2A, B2B, B2C, C2C 



Ces sigles distinguent le commerce inter-entre- 
prises (Business to Business ou B2B) du com- 
merce avec les particuliers (Business to 
Consumer ou B2C). II y a aussi les echanges 
entreprises-administrations (B2A ou Business to 
Administration) et ceux entre particuliers 
comme les encheres, petites annonces, etc. (Con- 
sumer to Consumer ou C2C). 



Pour eviter les commandes impayees liees a des numeros de cartes ban- 
caires errones, la societe YAPS fait appel a la banque BarkBank pour 
valider ces numeros. Cette validation s'effectue lorsque les clients pas- 
sent une commande en ligne. Les donnees sont echangees entre les deux 
societes au format XML et sont transporters par le protocole HTTP. 
Ces donnees contiennent les informations de la carte bancaire et sont 
envoyees a la societe BarkBank, celle-ci effectue la validation et renvoie 
un statut : valide ou non (voir cas d'utilisation « Acheter des articles »). 

Pour le transport des animaux, YAPS fait aussi appel a une societe 
externe. Elle envoie des donnees a PetEx lui permettant d'acheminer 
d'un point vers un autre une commande d'animaux domestiques (voir le 
cas d'utilisation « Creer un bon de commande » du premier chapitre). 

Ces echanges se font via des services web. 



Les standards autour des services web 



/, URL, URI, URN, URC 



URL (Uniform Resource Locator) est une 
chaine de caracteres servant a localiser des res- 
sources consumables a I'aide d'un navigateur. Les 
URL sont un sous-ensemble d'URI (Unified 
Resource Identifier), qui est un mode d'adres- 
sage elabore de ressources (utilise notamment 
pour le Web). Plus precisement, I'URI est un ele- 
ment generique qui se decline en trois sous- 
ensembles : 

• TURN (Uniform Resource Name) qui permet 
un nommage unique et permanent (meme si la 
ressource devient inaccessible) ; 

• I'URC (Uniform Resource Characteristic) 
qui decrit les caracteristiques de la ressource ; 

• I'URL qui donnesa localisation. 



A XML-RPC 



XML-RPC (Remote Procedure Call) est un pro- 
tocole qui a ete concu pour permettre a des struc- 
tures de donnees complexes d'etre transmises, 
executees et renvoyees tres facilement sur des 
plates-formes heterogenes. XML-RPC est I'ancetre 
de Soap. 

► http://www.xmlrpc.com/ 



Les services web s'appuient sur un ensemble dAPI et de protocoles 
standardisant l'invocation de composants applicatifs. lis sont decrits en 
XML par des documents WSDL qui precisent les methodes pouvant 
etre invoquees, leurs signatures et les points d'acces du service (URL, 
port). UDDI est le standard de recherche de ces services et Soap le pro- 
tocole utilise pour echanger ces informations. Java EE 5 a considerable- 
ment simplifie le developpement des services web. Nous haurons done 
pas a manipuler directement tous ces standards. II est cependant impor- 
tant d'en connaitre la definition et leur role dans 1' architecture globale 
des services web. 

Soap 

Inspire de XML-RPC, Soap (Simple Object Access Protocol) est le proto- 
cole utilise par les services web. Fonde sur XML, ce protocole autorise 
l'interoperabilite avec differents environnements logiciels quelle que soit 
leur plate-forme d'execution (comme DCOM ou Corba HOP). En 
effet, Soap permet la transmission de messages entre objets distants, en 
invoquant des methodes sur des objets physiquement situes sur une autre 
machine. Le transfert se fait le plus souvent a I'aide du protocole HTTP. 

Le protocole Soap se decompose en deux parties : 

• une enveloppe, contenant des informations sur le message lui-meme 
afin de permettre son acheminement et son traitement ; 

• un modele de donnees, definissant le format du message, e'est-a-dire 
les informations a transmettre. 
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Apres avoir presente le protocole Soap, decrivons plus precisement sa 
manipulation. En premier lieu, il est important de noter qu'en pratique 
Soap ne se manipule pas directement. En effet, en Java EE 5, l'API uti- 
lisee pour echanger des messages est JAX-WS {Java API for XML-based 
Web Services). Cela nous permet done de nous concentrer sur le developpe- 
ment et l'invocation de services web, sans nous soucier du protocole Soap. 

UDDI 

UDDI {Universal Description, Discovery and Integration) est une specifica- 
tion definissant la maniere de publier et de retrouver des services web. 
C'est un annuaire qui offre des mecanismes d'enregistrement et de 
recherche de services web developpes et publies par des entreprises. UDDI 
fournit des informations sur l'auteur de services web (adresse, contact...), 
sur la classification (societe informatique, hopital...) et sur les moyens 
techniques permettant de les invoquer. Chaque entreprise peut avoir son 
propre annuaire UDDI pour publier ses services, mais elle peut aussi uti- 
liser des annuaires publics comme ceux de Microsoft, IBM ou SAP. 

UDDI n'est pas fondamentale aux services web comme Test XML, Soap 
ou WSDL. Nous n'aborderons done pas la publication de services dans 
cet ouvrage. 

WSDL 

WSDL ( Web Service Description Language) est le format XML specifie 
par le W3C permettant de definir un service web qui utilise le protocole 
Soap. 

On expose ainsi au format XML la signature d'un service web accessible 
sur Internet. Cette signature inclut les operations exposees, le type de ses 
parametres d'entrees-sorties, et l'adresse reseau a laquelle on pourra 
l'invoquer. UDDI permet de retrouver un service web, et WSDL de 
decrire ses methodes. 

En fait, WSDL est scinde en deux parties qu'on appelle abstraite et con- 
crete. La signature du service, ses methodes et ses parametres sont 
decrits de maniere abstraite. Cette partie est ensuite liee a un protocole 
de communication et a un format de messages concrets. Ainsi, la partie 
abstraite est totalement decouplee de la maniere concrete permettant 
d'appeler le service. 



Approfondir Soap 

► http://www.w3.org/TR/soap/ 

111 Annick Fron, Architectures reparties en 

Java : RMI, CORBA, JMS, sockets, SOAP, 

services web, Dunod, 2007 
Q Jean-Marie Chauvet, Services Web avec 

Soap, WSDL, UDDI, ebXML, Eyrolles, 2002 
Q Hubert Kadima, Valerie Monfort, Les Web 

services - Techniques, demarches et 

outils : XML, WSDL-, SOAP, UDDI, 

Rosetta, UML, Dunod, 2003 
III Robert Englander, Java et SOAP, O'Reilly, 

2003 



//. Pages blanches, jaunes et vertes 

Un annuaire UDDI est constitue de pages blanches 
(nom de I'entreprise, adresse, contacts), jaunes 
(secteurs d'affaires relatifs au web service) et 
vertes (informations techniques des services web 
proposes). 



Approfondir uddi 

► http://uddi.xml.org 

► http://uddi.sap.com 

► http://uddi.ibm.com/ubr/registry.html 

► http://uddi.microsoft.com 



APARTE WS-I 

WS-I, ou Web Services Interoperability, est un 
consortium d'industriels promouvant I'interopera- 
bilite des services web au travers d'une implemen- 
tation nommee WS-I Basic Profile. II edite aussi 
des guides de bonnes pratiques, des outils permet- 
tant de tester la conformite de services avec ses 
recommandations, ainsi que des forums de discus- 
sion dedies aux developpeurs. 
► http://www.ws-i.org/ 



W3C 

Le World Wide Web Consortium (W3C) est un con- 
sortium promouvant la compatibilite des technolo- 
gies web telles que HTML, XHTML, XML, RDF, CSS, 
Soap, WSDL, UDDI, etc. 
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Extrait de fichier WSDL 

APPROFONDIR WSDL 

► http://www.w3.org/TR/wsdl 

► http://www.w3schools.com/wsdl/ 
default.asp 

CO De Sanjiva Weerawarana, Francisco 
Curbera, Frank Leymann, Tony Storey et 
Donald F. Ferguson, Web Services 
Platform Architecture, Prentice Hall, 2005 



A XMLetXSD 

Les services web sont intimement lies a XML et 
XSD (XML Schema Definition). Si vous n'etes 
pas familier avec ce formalisme, consulter les refe- 
rences suivantes : 

£0 Antoine Lonjon, Jean-Jacques Thomasson 

et Libera Maesano , Modelisation XML, 

Eyrolles, 2006 
CO Renaud Fleury, Java/XML, Eyrolles, 2004 

► http://www.w3.org/XML/ 

► http://www.w3.org/XML/Schema Cet extrait de document WSDL commence par l'en-tete def i ni ti ons Q- 

Cet element peut prendre plusieurs attributs facultatifs qui definissent 
des noms de domaines a utiliser dans la suite du document. Dans notre 
exemple, la definition recoit le nom ValidationService 0. Le service 
web portant ce meme nom 0 peut etre invoque a partir d'une URL 
donnee 0. 

Ce document utilise certains noms de domaines definis a l'aide de 
prefixes : 

• tns : abrege de « this namespace » (ce nom de domaine), c'est-a-dire 
le nom de domaine d'accueil contenant le service ; 

• xsd : nom de domaine du schema XML (XSD) utilise pour definir 
les types du document ; 

• soap : nom de domaine utilise pour la liaison Soap. 

Nous ne nous attarderons pas plus sur WSDL car, comme vous le 
decouvrirez plus loin, ce document est genere automatiquement et n'a 
pas a etre developpe manuellement. 



<def i ni ti ons targetNamespace="http : //val i dator . barkbank . com/" 
0 name="ValidationService"> 0 

<types> 

<xsd: schema> 

<xsd : i mport namespace="http : //val i dator . barkbank . com/" 
schemaLocation="http: //local host : 8080/barkbank/ 

ValidationService?xsd=l"/> 

</xsd : schema> 
</types> 

<message name="Val i dateCard"> 

<part name="parameters" el ement="tns : Val i dateCard"/> 
</message> 
(...) 

<service name="Val i dati onServi ce"> 0 
<port name="ValidationPort" 

bi ndi ng="tns : Val i dati onPortBi ndi ng"> 
<soap: address location= 

"http : //l ocal host : 8080/barkbank/Val i dati onServi ce"/> 0 
</port> 
</service> 
</definitions> 



Rappel Sigles et acronymes 



JAX-WS 2.0 



JAX-WS est la nouvelle appellation de JAX-RPC (Java API for XML 
Vous trouverez en annexe un lexique d'acronymes Based RP Q qui p er met de developper tres simplement des services web. 
etde sigles. JAX-WS fournit un ensemble d'annotations pour mapper la correspon- 
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dance Java-WSDL. II suffit pour cela d'annoter directement les classes 
Java. En ce qui concerne le client, JAX-WS permet d'utiliser une classe 
proxy pour appeler un service distant et masquer la complexite du proto- 
cole. Ainsi, ni le client ni le serveur n'ont besoin de generer ou de parser 
les messages Soap. JAX-WS s'occupe de ces traitements bas niveau. 

Exemple d'annotations JAX-WS dans une classe Java 

@WebService 

public class Validation { 
©WebMethod 

public String val i dateCredi tCard() { 
(...) 

} 

} 

Dans l'exemple ci-dessus, une classe Java utilise des annotations JAX- 
WS qui vont permettre par la suite de generer un document WSDL. 



Architecture Design pattern Proxy 

Le Proxy, tres utilise pour la gestion d'objets distri- 
bues, ajoute un niveau de redirection vers une 
methode d'un objet. L'idee est de construire un 
Proxy capable de communiquer avec un objet dis- 
tant sans que I'appelant fasse de differences entre 
un acces local ou un acces distant. 



A JAX-RPC 

JAX-RPC {Java API for XML-based Remote 
Procedure Call) est une API permettant de creer 
des services et clients web bases XML et RPC. 
► http://java.sun.com/webservices/jaxrpc/ 
index.jsp 



JAXB 2.0 

JAX-WS s'appuie sur 1API JAXB 2.0 pour tout ce qui concerne la cor- 
respondance entre documents XML et objets Java. JAXB (Java Architec- 
ture for XML Binding) facilite cette correspondance bidirectionnelle en 
fournissant un niveau d'abstraction plus eleve que SAX ou DOM et en 
s'appuyant sur des annotations. 

LAPI JAXB, definie dans le paquetage javax.xml .bind, fournit un 
ensemble d'interfaces et de classes que les applications utilisent pour 
produire un schema XML, generer des classes Java ou des documents 
XML. Les types de manipulations sont les suivantes (figure 9-1). 



Schema XML 



<xs : complexType> 

:• ■ - rnonr 

</xs:sequ«nce> 
</ x s : ccraplexType > 
</xs : 5ch«ma> 



Compilateur de schema 

xj£ 



Generateur de schema 

schemagen 



Classes 



I 



I est valide par 



instancie 



I 



A 



^individuals 
<i<j>K/id> 
<fit5tnamo> 
John 

</firstname> 
<homeAddcess> 

</homeAddress> 
</ individuals 



(+validation) 



marshal 
(^validation) 
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Document XML 



Objets 



APPROFONDIR JAX-WS 



► http://java.sun.com/webservices/jaxws/ 
index.jsp 

► http://jax-ws.dev.java.net/ 



APPROFONDIR JAXB 



► https://jaxb.dev.java.net/ 

► http://java.sun.eom/webservices/docs/2.0/ 
tutorial/doc/JAXBWorks.html 

Pour savoir comment transformer un graphe 
d'objets en XML en utilisant JAXB, vous pouvez 
consulter un article que j'ai ecrit pour le site DevX : 

► http://www.devx.com/Java/Article/34069 



Figure 9-1 

Les phases de manipulation JAXB 
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LU 
UJ 

g 
JO 

"i • Grace a son compilateur de schema, JAXB peut generer un ensemble 

| de classes Java a partir d'un schema XML. 

g 1 • L'action inverse est possible grace a un generateur de schema. A partir 

3 d'une grappe de classes Java, JAXB peut creer un schema XML. 

§ • La classe Unmarshal 1 er transforme un document XML en un graphe 

5 d'objets. 

• La classe Marshal ler fabrique un graphe d'objets a partir d'un docu- 
ment XML. 

Toutes ces fonctionnalites font que JAXB est souvent associe aux ser- 
vices web. Les services web utilisent l'API JAXB pour transformer des 
objets en messages XML et inversement. 

Par exemple, si on veut obtenir une representation XML de la classe 
Customer, il suffit de l'annoter avec @javax.xml .bind. annotation. 
Xml RootElement Q. D'autres annotations permettent de specifier qu'un 
attribut est un identifiant © ou de renommer © un attribut (e-mai 1 au 
lieu de email, par exemple). 

Exemple d'annotations JAXB dans la classe Customer 

@Xml RootElement Q 

public class Customer { 

@Xml ID © 

private String id; 
private String firstname; 
private String lastname; 
@XmlAttribute(name = "e-mail") © 
private String email; 
(...) 

} 

Ces annotations permettent alors de generer le document XML suivant 
a partir de la classe, et inversement. 

Representation XML de la classe Customer 

<?xml version="1.0" encodi ng="UTF-8" standalone="yes"?> 
<customer> Q 

<id>1234</id> © 

<fi rstname>Paul </fi rstname> 

<1 astname>Smi th</l astname> 

<e-mai l>yaps@petstore . com</e-mai 1 > Q 
</customer> 



244 



SAX et DOM 



II existe deux grandes families de solutions pour lire un fichier XML en 
Java : 

• SAX {Simple API for XML) est une solution tres pratique pour parser des 
fichiers XML simples. L'analyseur SAX s'occupe d'interpreter le docu- 
ment XML, identifiant les different attributs et balises. Des qu'un ele- 
ment est reconnu, SAX avertit le programme afin que celui-ci fasse un 
traitement approprie. Le programme recoit done des evenements du 
type « ouverture de la balise X », « zone de texte », « fermeture de la 
balise X ». Apres le passage de SAX, seules restent les informations que 
le programmeur a lui-meme traitees et placees dans d'autres structures 
de donnees. 

• DOM (Document Object Model) est plus simple a comprendre puisqu'il lit 
I'integralite du document XML afin de construire sa representation en 
memoire. Ensuite, le programme peut librement et rapidement par- 
courir cette representation interne pour y garder les informations sou- 
haitees. DOM n'est pas recommande pour des documents de taille 
importante a cause de I'occupation memoire que les donnees pour- 
raient prendre. 



Services web 



Souvent decrits comme le nouveau modele de reference pour les sys- 
temes d'information, les services web permettent a des applications de 
dialoguer a distance, et ceci independamment des plates-formes et des 
langages sur lesquels elles reposent. Pour communiquer, les services web 
s'appuient sur les standards que nous venons de voir. Cette communica- 
tion est basee sur le principe de demandes et de reponses (en fait, des 
messages XML) transported par le protocole HTTP. 

Les services web sont aujourd'hui incontournables et se presentent 
comme le nouveau paradigme des architectures logicielles ou architec- 
tures orientees services (SOA). Cette technologie tend a s'imposer 
comme le nouveau standard en termes d'integration et d'echanges B2B. 
Grace aux services web, les applications peuvent etre vues comme un 
ensemble de services metier, structures et dialoguant selon un standard, 
plutot qu'un ensemble d'objets et de methodes. 



SOA 



Le terme SOA {Service-Oriented Architecture) 
definit une architecture logicielle a base de ser- 
vices. Un service designe une action executee par 
un composant fournisseur a I'attention d'un com- 
posant consommateur. 



Exemple de service web 

La plate-forme Java EE 5 cache tous les mecanismes de bas niveau et 
rend l'ecriture d'un service web extremement simple. En effet, il suffit 
d'une seule annotation JAX-WS Q pour transformer une simple classe 
Java en service web. 
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Exemple simple de service web 

©WebService Q 

public class Validation { 

public String validateCreditCard(String ccNumber, 

String ccType, String ccExpi ryDate) { 

(...) 

return "OK"; 

} 



Exemple d'appel a un service web 

II est tout aussi facile de consommer un service web. Bien que la tuyau- 
terie technique utilise des classes generees, des proxy pour communiquer 
a distance et toute la panoplie de specifications que nous venons de voir 
(WSDL, Soap et JAXB), une simple annotation @WebServiceRef © 
permet d'injecter une reference a un service web. 

Exemple simple d'appel a un service web 

public class ShoppingCartController { 
©WebServiceRef © 

private ValidationService validationService; 

private void validateCreditCard(CreditCard creditCard) { 
Validation validation=validationService.getValidationPortO ; 
val i dati on . val i dateCard (credi tCard . getCredi tCardNumber () , 

credi tCard . getCredi tCardType () , 
c reditCard. getCredi tCardExpDateO) ; 

} 



Annotations JAX-WS 

Les annotations JAX-WS sont specifiques aux services web. Elles per- 
mettent d'agir sur la structure du document WSDL en modifiant cer- 
tains parametres du service ou des methodes qui le composent. Dans 
cette section, nous allons decrire plus finement le comportement de ces 
annotations. 
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Le service 



L'annotation principale pour definir un service web est 
©javax. jws.WebService. Elle utilise plusieurs attributs et peut, par 
exemple, specifier la localisation d'un service web. 

Code de l'annotation @javax.jws.WebService 

package javax.jws; 

©Target ({TYPE}) ©Retention (RUNTIME) 
public ©interface WebService { 

String name() default ""; 

String targetNamespace() default ""; 
String servi ceName() default ""; 

String wsdl Location () default ""; 

String portName() default ""; 

String endpoi ntlnterfaceQ default ""; 



Cette annotation s'applique a une classe. 



Norn donne au service web mappe sur I'element 
portType du WSDL. 



Specifie le namespace XML utilise dans le WSDL. 



< URL d'acces au WSDL definissant le service. 



La methode 



Si une classe est annotee par ©WebService, alors par defaut, toutes ses 
methodes publiques peuvent etre appelees. Si on veut restreindre cette 
regie et ne publier que certaines methodes, on peut alors utiliser l'anno- 
tation ©javax.jws. WebMethod. Celle-ci permet aussi de modifier certains 
attributs par defaut. 

Code de l'annotation @javax.jws.WebMethod 

package javax.jws; 

©Target ({METHOD}) ©Retention (RUNTIME) 
public ©interface WebMethod { 

String operationName() default ""; 
boolean exclude () default false; 
String action() default ""; 

} 

Une methode qui n'a pas de parametres de retour peut etre annotee par 
©OneWay. 

Code de l'annotation @javax.jws.Oneway 

package javax.jws; 

©Target ({METHOD}) ©Retenti on (RUNTIME) 
public ©interface Oneway {} 



Cette annotation s'applique a une methode. 



Redefinit le nom de la methode. 



Ne publie pas la methode si excl ude=true. 



Valeur de Taction Soap. 



Cette annotation s'applique a une methode. 
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L'exemple suivant redefinit le nom de la methode en Del i ver au lieu de 
del iverltems Q et, comme elle ne possede pas de parametres de retour, 
elle est annotee ©OneWay©. 



Service web redefinissant le nom de la methode 



@WebService 

public class Delivery { 

@WebMethod(operationName = "Deliver")© 
©Oneway© 

public void deliverItems(DeliveryPlace from, 

DeliveryPlace to, String reference) { 

(...) 

} 



Cette annotation s'applique a un parametre. 



Redefinit le nom du parametre. 



Nom du wsdl : part qui represente le parame- 
tre. 



Namespace XML du parametre. 



Indique que le parametre doit etre mis dans I'en- 
tete (header) de Soap et non dans le corps 
(body). 



Indique si le parametre est en entree (IN), sortie 
(OUT), ou les deux(INOUT). 



Cette annotation s'applique a une methode. 



Definit le nom de la valeur de retour. 



Les parametres de la methode 

Les parametres de la methode ainsi que la valeur de retour peuvent aussi 
etre changes. L' annotation @javax. jws .WebParam permet de controler la 
generation du WSDL qui concerne les parametres de la methode. 

Code de I'annotation @javax.jws.WebParam 

package javax.jws; 

©Target ({PARAMETER}) ©Retenti on (RUNTIME) 
public ©interface WebParam { 

String name() default ""; 
String partName() default ""; 

String targetNamespace() default ""; 
boolean headerQ default false; 



Mode mode() default IN; 

} 

Lannotation ©javax. jws .WebResult est presque identique, mais elle 
annote la valeur de retour de la methode. 

Code de I'annotation @javax.jws.WebResult 

package javax.jws; 

©Target ({METHOD}) ©Retention(RUNTIME) 
public ©interface WebResult { 

String nameQ default ""; 
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String partName() default ""; 

String targetNamespace() default ""; 
boolean header() default false; 



Le code suivant utilise ces deux annotations pour changer le nom des 
parametres (expi ryDate au lieu de ccExpi ryDate Q) ou leur mode © 
(WebParam.Mode.IN). L' annotation OWebResul t (name = "cardStatus") © 
permet de nommer la valeur de retour qui est de type Stri ng. 

Service web redefinissant les parametres de la methode 

@WebService 

public class Validation { 
OWebMethod 

@WebResult(name = "cardStatus") O 

public String val i dateCredi tCard( 

@WebParam(name = "creditCardNumber" , 

© mode = WebParam . Mode . IN)Stri ng ccNumber, 
@WebParam(name = "creditCardType")String ccType, 
©WebParam (name = "expi ryDate") String ccExpi ryDate) ©{ 
(...) 



} 



} 

Pour mieux comprendre l'utilite de ces annotations, regardez attentive- 
ment les deux versions de schema XML. Ces schemas representent les 
parametres de la methode val i dateCredi tCard avec et sans annotations 
JAX-WS. 

Extrait du schema XSD des parametres de la methode sans annotations 



<xs : compl exType name="val i dateCredi tCard"> © 

<xs : sequence> 

<xs:element name="argO" type="xs : stri ng" mi nOccurs="0"/> 
<xs:element name="argl" type="xs : stri ng" mi nOccurs="0"/> 
<xs:element name="arg2" type="xs : stri ng" mi nOccurs="0"/> 
</xs:sequence> 
</xs : compl exType> 



0 
0 

0 



<xs : compl exType name= 
<xs : sequence> © 

<xs: element name= 
</xs:sequence> 

</xs : compl exType> 



'val idateCreditCardResponse"> 

'return" type="xs : stri ng" mi nOccurs="0"/> 



Nom du wsdl :part qui represents la valeur 
de retour. 



Namespace XML de la valeur de retour. 



Indique que la valeur de retour doit etre mise 
dans I'en-tete (header) de Soap et non dans le 
corps (body). 



Remarque Les fichiers XSD 



Comme nous le verrons par la suite, les fichiers 
XSD sont generes automatiquement puis deployes 
avec les classes du service web. 
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Extrait du schema XSD des parametres de la methode avec annotations 

<xs : compl exType name="Val i dateCard"> 0 

<xs:sequence> 

<xs:element name="creditCardNumber" type="xs: string" minOccurs="0"/> 0 
<xs:element name="creditCardType" type="xs:string" minOccurs="0"/> 0 
<xs:element name="expi ryDate" type="xs: string" minOccurs="0"/> 0 

</xs:sequence> 

</xs : compl exType> 

<xs : compl exType name="Val i dateCardResponse"> 
<xs:sequence> 0 

<xs: element name="cardStatus" type="xs: string" minOccurs="0"/> 
</xs:sequence> 
</xs: compl exType> 

Le nom de la methode O peut etre modifie en utilisant l'annotation 
©WebMethod. Idem pour le nom des parametres 0 (avec OWebParam) et du 
type de retour 0 (@WebResult). 



Artefact 



Un artefact est compose de I'ensemble des docu- 
ments necessaires a un service web. On peut citer 
par exemple le document WSDL, ou encore les 
classes Java qui formeront les messages 
d'echanges XML. 



Comment developper un service web 

Comme nous venons de le voir dans ces quelques exemples, le develop- 
pement d'un service web est relativement simple bien que plusieurs 
technologies soient mises en oeuvre. Telle est la force de Java EE 5. Pour 
cela, il y a plusieurs phases de generation de code qui entrent en jeu et 
qui mettent en ceuvre toute la tuyauterie technique. Le developpement 
et 1'utilisation d'un service web component quatre phases : 

• developpement du service web ; 

• generation des artefacts serveurs ; 

• generation des artefacts clients ; 

• appel du service web. 



Precision Service web et EJB 

II y a deux moyens d'implementer un service web. 
Le premier repose sur les servlets ou une simple 
classe annotee est deployee dans un conteneur 
web (dans un WAR). L'autre moyen repose sur les 
EJB sans etat qui sont annotes a la fois par 
@Statel ess et @Webservi ce, puis deployes 
dans un conteneur EJB (dans un JAR ou EAR). Dans 
cet ouvrage, nous utiliserons la premiere solution. 



Developper la classe du service web 

Prenons 1' exemple du service web de la BarkBank qui permet de valider une 
carte bancaire. La classe Validation 0 publie une methode © 
val idateCreditCard (renommee en ValidateCard Q) qui prend en para- 
metres le numero de la carte, son type (Visa, Master Card, etc.) et la date 
d'expiration. Tous ces parametres 0 sont de type Stri ng ainsi que la valeur 
de retour 0 correspondant au statut (numero invalide, carte expiree, etc.). 

Voila, tout est dit. N'est-ce pas magique ? Si les valeurs par defaut vous 
conviennent, vous pouvez meme limiter les annotations a la seule 
©WebService. Contrairement aux EJB, un service web ha pas besoin 
d'implementer une interface. 
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@WebService 

public class Validation { Q 



©WebMethod (ope rati onName = "Val i dateCard") Q 

©WebResul t(name = "cardStatus") 0 

public String val i dateCredi tCard( Q 

@WebParam(name = "credi tCardNumber")Stri ng ccNumber, 
@WebParam(name = "credi tCardType")Stri ng ccType, 0 
@WebParam(name = "expi ryDate")Stri ng ccExpi ryDate) { 

// L'algorithme de verification n'est pas detaille 

} 



Generer les artefacts serveurs 

Cette classe developpee, BarkBank doit generer les artefacts de son ser- 
vice, c'est-a-dire le document WSDL et les classes Java qui formeront 
les messages d'echanges XML. Pour cela, on utilise l'utilitaire wsgen 
fourni avec GlassFish. A partir de la classe Validation, l'utilitaire wsgen 
genere les elements suivants : 

• La classe Val i dateCredi tCard (du nom de la methode du service) cor- 
respond aux parametres passes au service. Cette classe ne contient que 
les trois attributs de type String (numero, type et date d'expiration) 
ainsi que les accesseurs. Comme elle est responsable du transport des 
parametres au format XML, cette classe utilise les annotations JAXB. 

• La classe Val i dateCredi tCardResponse (du nom de la methode suf- 
fixee par Response) correspond a la valeur de retour. Cette classe est, 
elle aussi, annotee par JAXB. 

• Le document WSDL decrivant le service web et son schema XSD. 

Ci-apres le diagramme de classes representant le service web Val i dati on 
ainsi que les artefacts generes dans le sous-paquetage jaxws (figure 9-2). 



Annotation @OneWay 



Les methodes annotees OOneWay n'ont pas de 
valeur de retour. II n'y a done pas de classes 
Response generees pour ce type de methodes. 



Validation 



+validateCard(creditCardNumber : String, creditCardType : String, expiryDate : String) : Stiing 



ValidateCredrtCard 



jaxvs 



■creditCardNumber : String 
■creditCardType : String 
-e>pii ypate : String 



Val idateCredrtCardReapon»e 



Figure 9-2 

Artefacts serveur du service web de validation 



Bien que vous hayez pas a vous soucier des classes generees, il est inte- 
ressant de voir un extrait de leur contenu. 
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La classe ValidateCreditCard repre- 
sente les parametres de la methode de valida- 
tion. Elle utilise les annotations JAXB 
@Xml RootEl ement et @Xml El ement pour 
generer un message XML. 
Les noms des attributs (ex. expi ryDate) cor- 
respondent aux noms specifies dans les annota- 
tions JAX-WS du service web : 
@WebParam(name = "expi ryDate") 
String ccExpi ryDate 



La classe ValidateCreditCardResponse 
represente la valeur de retour. Le nom 
cardStatus fait reference a I'annotation 
JAX-WS du service web : 
@WebResult(name = "cardStatus") 



Classe generee correspondant aux parametres 

| @Xml RootEl ement (name = "Val i dateCard") 
public class ValidateCreditCard { 

@Xml El ement (name = "credi tCardNumber") 
private String creditCardNumber; 
@Xml El ement (name = "credi tCardType") 
private String credi tCardType; 
@Xml El ement (name = "expi ryDate") 
private String expi ryDate; 



Classe generee correspondant aux valeurs de retour 
@Xml RootEl ement 

public class ValidateCreditCardResponse { 

@Xml El ement (name = "cardStatus") 
private String _return; 



Generer les artefacts clients 



TELECHARGER Le code genere 



Retrouvez la totalite des sources generees sur le 
site YAPS Pet Store a I'adresse suivante : 
► http://www.antoniogoncalves.org 



BarkBank a developpe son service web, genere ses artefacts serveurs et a 
deploye le tout sur son serveur a une URL donnee. Maintenant, pour 
que YAPS puisse acceder a ce service, il lui faut generer les artefacts cote 
client. Cette operation se fait via l'utilitaire wsimport. Celui-ci prend en 
parametres l'URL du WSDL du service web. A partir de ce WSDL, 
wsimport genere les elements suivants : 

• Val i dati onServi ce est la classe principale qui est utilisee dans le code 
de l'application YAPS Pet Store. Celle-ci retourne l'interface 
Validation, qui possede la meme signature que le service web. 

• Une fabrique (ObjectFactory) pour creer les deux memes classes 
ValidateCard et Val i dateCardResponse. Grace aux annotations 
JAXB, ces classes generent les messages XML. 

Le diagramme ci-apres nous montre les differentes classes et interfaces 
generees et utilisees par le client pour invoquer le service web (figure 9-3). 



Appeler un service web 

Une fois le service web deploye et les artefacts clients generes, il est 
temps de les utiliser pour invoquer le service web depuis l'application 
YAPS Pet Store. Cette tache, assez complexe en J2EE, s'est considera- 
blement simplifiee en Java EE 5 grace a l'injection et a I'annotation 
@javax.xml .ws .WebServi ceRef . En effet, il suffit d'annoter une classe et 
d'utiliser les artefacts generes pour appeler un service web. 
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«interface» 

Validation 

+validateCard(creditCardNumber : String, creditCardType : String, expiryDate : String) : String 



ObjectFactory 



+createValidateCardResponse() : ValidateCardResponse 
♦createValidateCardO : ValidateCard 

+createValidateCardResponse(value : ValidateCardResponse) : JAXBEIement<ValidateCardResponse> 
+createValidateCard(value : ValidateCard) : JAXBEIement<ValidateCard> 





ValidateCard 



itCardN umber : String 
itCardType : String 
: String 



Figure 9-3 

Artefacts client du serveur web de validation 



Extrait du code appelant le service web 

public class Shoppi ngCartControl 1 er { 



@WebServiceRef 

private Val idationService validationService; 

private void val i dateCredi tCard(Credi tCard creditCard) { 
Val idation val idation=val idationService. getVal idationPortO ; 

String statusCard = val idation .val idateCard( 

credi tCard . getCredi tCardNumberO , 
credi tCard . getCredi tCardTypeO , 
credi tCard. getCredi tCardExpDateO) ; 

(...) 

} 

} 

L'annotation ©WebServiceRef peut prendre plusieurs parametres. Dans 
l'exemple precedent, nous aurions pu lui fournir FURL du document 
WSDL de la maniere suivante 

@WebServiceRef (wsdl Location = 

"http : //l ocal host : 8080/barkbank/Val i dationServi ce?WSDL") 
private ValidationService validationService; 

Code de l'annotation @javax.xml.ws.WebServiceRef 

package javax.xml .ws; 

©Target ({METHOD , FIELD}) ORetenti on (RUNTIME) 
public ©interface WebServiceRef { 

String nameQ default "" 



Le service web peut-etre appele a partir de 
n'importe quelle classe (un managed bean dans 
notre cas). 



La classe ValidationService est generee 
par wsimport. L'annotation 

OWebServi ceRef permet d'injecter la refe- 
rence du service web. 

On recupere I'interface Val i dati on qui a ete 
generee par wsimport. 



Appel du service web en lui passant les parame- 
tres et en recuperant la valeur de retour. 



Cette annotation s'applique a une methode ou a 
un attribut. 



Nom local du service web. 
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URL du document WSDL decrivant le service ► 
web. 

Nom local du service web specifique au serveur ► 
d'applications. 

Au lieu de specifier I'URL du service via ► 
wsdl Location, on peut directement speci- 
fier le nom de I'interface generee. 



Code de I'annotation @javax.xml.ws.WebServiceRef 

String wsdl LocationO default ""; 

String mappedName() default ""; 

Class type() default Object . cl ass ; 
Class valueQ default Object. class; 



La vision globale 

Rien ne vaut un schema pour eclaircir le mecanisme d'invocation d'un 
service web (figure 9-4). 



Figure 9-4 

Communication entre client 
et service web 



class ShoppingCartController{ 
@WebServiceRef 

ValidationService validationService 
(...) 

getValidationPort().validateCard 
} 
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1 








ValidateCreditCard 




ValidateCreditCard Response 


Artefacts clients 



Client 



XML 



1/ 



HTTP 



XML 



@WebService 
public class Validation { 
@WebMethod 

String validateCreditCardf) { 



} 



ValidateCreditCard 



4 

1A/SDL 
XSD 



ValidateCreditCard Response 



Artefacts serveurs 



Service web 



Pour que le client puisse invoquer le service web, on annote par 
©WebServiceRef la classe generee ValidationService (@WebServi ceRef 
permet au conteneur d'injecter une reference du service). On appelle ce 
service en lui passant le numero de carte de credit, le type et la date 
d'expiration. Ceci a pour effet d'affecter ces donnees dans la classe 
Val idateCreditCard O- Grace aux annotations JAXB, cette classe 
genere un document XML qui peut alors transiter par HTTP © dans 
une enveloppe Soap. A la reception de ce message XML, le service web 
utilise les annotations JAXB pour reconstruire un objet 
ValidateCreditCard @. II valide alors les donnees bancaires puis 
retourne le resultat de cette validation via la classe 
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ValidateCreditCardResponse Q- En utilisant le meme mecanisme, cette 
classe est transformed en flux XML pour transiter a travers le reseau 0. 
Le resultat arrive enfin chez le client qui le retransforme en objet © et 
peut ainsi recuperer la valeur de retour. 



Les services web utilises par YAPS Pet Store 

Lapplication YAPS Pet Store utilise deux services web : la validation des 
numeros de cartes bancaires de la societe BarkBank et le service de 
transport de marchandises de PetEx. 



La validation des cartes de credit 

Pour verifier que les coordonnees bancaires sont exactes, YAPS a passe 
un partenariat avec la banque BarkBank Celle-ci possede un service 
web de validation de cartes bancaires. Ce service prend en parametres le 
numero de la carte, son type (Visa, MasterCard, etc.) et sa date d'expi- 
ration au format MM/AA (mois/annee). Lalgorithme de verification 
s'assure que la date d'expiration est superieure a la date du jour, et que le 
numero des cartes Visa est pair. 



Remarque L'algorithme de verification 

Comme pour I'existence de la societe YAPS, l'algo- 
rithme de verification des cartes bancaires est 
completement fictif. 




Figure 9-5 

Diagramme de classe 

du service web de validation 



Code du service web Validation 
©WebService 

public class Validation { 

@WebMethod(operationName = "ValidateCard") 

@WebResult(name = "cardStatus") 

public String validateCreditCard( 

@WebParam(name = "credi tCardNumber")Stri ng ccNumber, 
@WebParam(name = "creditCardType")Stri ng ccType, 
@WebParam(name = "expi ryDate")Stri ng ccExpi ryDate) { 

Calendar calendar = Cal endar . getlnstance() ; 
int year = getExpi ryYear(ccExpi ryDate) ; 
int month = getExpi ryMonth(ccExpi ryDate) ; 
int lastNumber = getLastNumber(ccNumber) ; 



La methode de validation prend en parametre le 
numero de la carte, son type, sa date d'expira- 
tion, et retourne le statut de la carte. 



On utilise des methodes utilitaires pour obtenir 
I'annee et le mois a partir du format MM/AA. 



255 



L'annee de la carte est inferieure a l'annee en 
cours. On renvoie le statut « L'annee de la carte 
bancaire est expiree ». 



L'annee de la carte est bonne, mais le mois est 
inferieur au mois en cours. On renvoie le statut 
« Le mois de la carte bancaire est expire ». 

La carte estvalide. 



Code du service web Validation 

if (year < calendar. get(Cal endar . YEAR)) { 

return "The year of the credit card is passed"; 

} 

if (year == calendar. get(Cal endar . YEAR) 

&& month < calendar. get(Cal endar . MONTH)) { 
return "The month of the credit card is passed"; 



} 

return "OK" 



Avertir le transporteur 

Pour la livraison des marchandises, YAPS utilise le transporteur PetEx. 
Celui-ci possede un service web lui permettant d'etre averti des trans- 
ports a effectuer. Ce service prend trois parametres : une adresse de 
depart, lieu ou la marchandise est chargee dans les camions, une adresse 
de livraison et une reference. Dans notre cas, cette reference correspond 
au numero de la commande. 



Figure 9-6 

Diagramme de classe 
du service web de livraison 




Notez dans le diagramme ci-dessus que la methode deliver prend un 
objet en parametre (DeliveryPlace). Cet objet correspond a une adresse 
qui permet a PetEx de charger ou de livrer une marchandise. On voit ici 
que les services web ne sont pas obliges d'utiliser seulement des types 
primitifs. De toute facon, lors de l'utilisation de wsgen et wsimport, des 
artefacts vont etre generes pour annoter la classe DeliveryPlace avec 
JAXB. Cet objet sera done transforme en flux XML. 

Code du service web Delivery 
©WebService 

public class Delivery { 

private Logger logger=Logger.getl_ogger("com.petex. transport") ; 

©WebMethod 
©Oneway 

public void deliverItems(DeliveryPlace from, 

DeliveryPlace to, String reference){ 



Ce service ne retourne pas de resultat. On peut ► 
done utiliser I'annotation ©OneWay. 
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logger. info("Delivery Order Received"); 
logger. info("Deliver from " + from); 
logger. info("Deliver to " + to); 
logger. i nfo("Reference n° " + reference); 



Nous ne nous interessons pas ici a la maniere 
dont le systeme de PetEx est averti. Nous nous 
contentons juste d'afficher les informations par 
le biais d'un logger. 



Appel des services web 

Ces deux services web sont invoques a differents endroits dans Implica- 
tion YAPS Pet Store. La creation d'un bon de commande fait intervenir 
plusieurs composants. Le client saisit son adresse de livraison et ses 
coordonnees bancaires a partir de la page confi rmorder. jsp, puis il 
clique sur Submit (figure 9-6). 





YAPS Pet Store 



Yet Another Pet Store 



Account Cart Son Off 



Birds 
Oils 
Dogs 
Fish 

Reptiles 



Confirm Order 



Personal information 



ftntonk: 



Ldstiuine : Ooncalyes 



.. . ,_ | ___■=■ 



Delivery Address 



"SU^iAl : [-12 
StreeU : 
•Cty: 
State: |u 

-Zipcotl. : \B70Z 
-Cutaibr : |USA 



Oakland 



"Credit card number : 1234123 4123d 
■Typo ! Vic 3 

bwiiv Udte (mm/tt): 01/09 



Figure 9-7 confirmorder.jsp 

Le clic sur Submit invoque Q la methode confi rmOrder() du managed 
bean Shoppi ngCartControl 1 er qui commence par invoquer le service web 
de validation des cartes ©. Si les donnees sont valides, alors il appelle la 



UML Stereotypes BCE 



Trois autres stereotypes ont ete integres a UML et 
sont souvent utilises pour le pattern MVC : 
«boundary» : (la vue) represente les objets qui 
realisent les echanges entre le systeme et les acteurs 
comme les pages web ou les interfaces graphiques. 
«control» : (le controleur) objet implemen- 
tant des mecanismes de collaboration comme les 
managed beans. 

«enti ty» : (le modele) objet representant les 
informations du systeme comme les entities. 



■o o o 



boundary 



entity 
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methode createOrderO de l'EJB stateless OrderBean ©. Ce dernier rend 
les donnees persistantes en base de donnees puis appelle le service web de 
livraison de PetEx © (deliveryltems). 



Figure 9-8 

Diagramme de sequences 
pour la creation d'un bon de commande 



HO o 

confirm order jsp : ShoppingCartController 



I 
I 

I 1: confirmOrderO 



2: validateCardQ 



3: createOrderO 



flean | 



_i--jn 4: clelivei Item si ) , 



On annote par @WebServi ceRef I'interface 
generee parwsimport. Le systeme d'injection 
se charge d'instancier I'objet. 



Cette methode est appelee lorsque le client sai- 
sit ses donnees bancaires et soumet le formu- 
laire. 



Appel d'une methode privee pour invoquer le 
service web. 



S'il n'y a pas d'exceptions, on invoque le state- 
less bean pour creer le bon de commande. 



En cas d'exceptions, on affiche un message sur 
la page web. 



Methode privee appelant le service web. 



Appel du service web en lui passant les parame- 
tres. 



Si les donnees bancaires sont invalides (statut 
different de OK), alors on lance une exception 
avec un message qui sera affiche a I'ecran. 



Appel du service web Validation a partir du managed bean 
public class ShoppingCartController 
©WebServiceRef 

private ValidationService val idationService; 

public String confirmOrderO { 
try { 

validateCreditCard(creditCard) ; 

order = orderBean . createOrder(customer , deliveryAddress, 
creditCard, shoppingCartBean.getCartltemsO) ; 
shoppi ngCartBean . empty () 

} catch (Exception e) { 
addMessage(e) ; 

} 

return "order . confi rmed" ; 

} 

private void val idateCreditCard(Credi tCard creditCard) { 
Validation val idation=val idationService.getValidationPortO ; 

String statusCard = validation.validateCard( 

creditCard . getCredi tCardNumberO , 
creditCard. getCredi tCardTypefJ , 
creditCard .getCredi tCardExpDateO) ; 

if (!"OK".equals(statusCard)) 
throw new CreditCardException( 

"Credit Card is invalid 



+ statusCard) ; 



} 
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Si la carte bancaire est valide, l'application appelle l'EJB stateless 
OrderBean pour creer un bon de commande. Une fois la creation effec- 
tive, l'EJB invoque le service web du transporteur pour l'avertir des 
livraisons qu'il doit faire. 

Appel du service web Delivery a partir du stateless session bean 
©Stateless 

public class OrderBean implements OrderRemote , OrderLocal { 
@WebServiceRef 

private Del i veryServi ce deliveryService; 

public Order createOrder(Customer customer, 

Address deliveryAddress, CreditCard creditCard, 
Li st<CartItem> cartltems) { 



Order order = new Order(customer , 

em.merge(deliveryAddress) , creditCard) ; 

Li st<OrderLi ne> orderLines = new ArrayLi st<OrderLi ne>() ; 
for (Cartltem cartltem : cartltems) { 

order Li nes . add (new Order Li ne (cartltem . getQuanti ty() , 
cartltem. getltem())) ; 

} 

order . setOrderLi nes (order Li nes) ; 
em. persi st (order) ; 

notifyTransporter(order) ; 

return order; 

} 

private void notifyTransporter (Order order) { 

DeliveryPlace from = new DeliveryPlace() ; 
from . setContact (Constants . COMPANY_NAME) ; 
from . setSt reet (Constants . COMPANY_STREET) ; 
from . setCi ty (Constants . COMPANY_CITY) ; 
from . setState (Constants . COMPANY_STATE) ; 
from . setZi pcode(Constants . COMPANY_ZIPCODE) ; 
f rom.setCountry (Constants. COMPANY_COUNTRY) ; 

DeliveryPlace to = new Del i very PI ace () ; 

to . setContact (orde r . getCustomer () . getLastname () ) ; 

to. setSt reet (order . getDel i veryAddress() . getStreetlO) ; 

to . setCi ty (orde r . getDel i ve ryAdd ress () . getCi ty () ) ; 

to. setState (order .getDel ive ryAdd ress () .getStateO) ; 

to. setZi pcode (order .getDel ive ryAdd ress () .getZi pcode()) ; 

to. setCountry (order . getDel ive ryAdd ress () . getCountryO) ; 

Delivery delivery = deliveryService. getDeliveryPort() ; 
delivery. del iverltems(f rom , to, order. getld() .toStringO) ; 

} 

} 



< Reference au service web. 



< Pour creer un bon de commande, il est neces- 
saire de disposer du contenu du panier electroni- 
que (cartltems) mais aussi de I'adresse de 
livraison, de la carte bancaire et des references 
du client. 

< Creation d'un objet bon de commande. 



< A partir du panier electronique, on cree des 
lignes de commande. 



< L'objet bon de commande est rendu persistant. 

< Appel d'une methode privee pour invoquer le 
service web. 



< Methode privee appelant le service web. 

< Le service du transporteur a besoin de connaTtre 
I'adresse de chargement et de livraison des arti- 
cles. 



< On invoque le service web en lui passant les 
deux adresses ainsi que le numero de bon de 
commande. 
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fa- B Yaps 

fa- & generated 
- com 

fa- Si barkbank. validator 

l ObjectFactory 
package-info. java 
ValidateCard 
■ -c) ft ValidateCardResponse 
I ft Validation 
c j ft ValidationService 
fa- §/ petex. transport 

a Deliverlterns 

— I 1 ft Delivery 

- c ; ft DeliveryPlace 
- DeliveryService 

— C; ft ObjectFactory 

- IM package-info. java 



Figure 9-9 Classes generees 
pour I'application YAPS Pet Store 



Paquetages des differents services web 

Les services web etant heberges par les partenaires BarkBank et PetEx, ils ne 
se trouvent pas dans I'application YAPS Pet Store. On utilise done des pro- 
jets differents pour accueillir ces sources. Pour distinguer les classes que Ton 
developpe (sre) de celles qui sont generees (generated) par wsgen ou 
wsimport, on se sert de repertoires differents. Ainsi, pour BarkBank, la 
classe du service web se trouve dans sre/com. barkbank. validator alors que 
les artefacts sontgeneres dans generated/com. barkbank. validator, jaxws. 
II en est de meme pour PetEx. 



fa- & BarkBank 
fa- & generated 

fa- Si com, barkbank. validator, jaxws 
I- @ ft ValidateCreditCard 
L ® ft ValidateCreditCardResponse 

- 11 ValidationService. wsdl 

- SValidationService_schemal.xsd 
fa- &src 

fa- Si com. barkbank. validator 
L c; ft validation 

Figure 9-10 Service web de BarkBank 



fa- & PetEx 

fa- & generated 

[ 3- S : com. petex. transport. jaxws 
L ft Deliverlterns 
xj DeliveryService. wsdl 
- [x] DeliveryService_schemal .xsd 
fa- &src 

fa- Scorn. petex. transport 
|- © ft Delivery 
L c ■ ft DeliveryPlace 

Figure 9-1 1 Service web de PetEx 



L'application YAPS Pet Store utilise l'outil wsimport pour generer les 
artefacts cote client des deux services web. Ces classes se trouvent dans le 
repertoire generated. 



Architecture 

Le diagramme suivant nous montre comment les services web externes 
de BarkBank et PetEx s'inserent dans l'architecture. Chaque service est 
invoque par un type de composant different de notre application. C'est 
un managed bean (ShoppingCartController) qui invoque le service de 
verification de cartes, alors que c'est un stateless bean (OrderBean) qui se 
charge d'avertir le transporteur (figure 9-12). 



Executer ('application 

Pour simuler la realite des applications distribuees, on aurait pu creer une 
instance GlassFish differente pour y deployer les applications de BarkBank, 
PetEx et YAPS Pet Store. II aurait meme meme ete possible de deployer 
chaque application sur un serveur physique distinct et les faire communi- 
quer au travers d'un reseau. Pour ne pas compliquer le deploiement et l'exe- 
cution de I'application, nous utiliserons done une seule et meme instance 
du serveur GlassFish pour heberger la totalite des composants. 
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Compiler 

Pour compiler les classes qui se trouvent dans les repertoires src et 
generer les artefacts cote serveur, on utilise les taches Ant barkbank- 
compile et petex-compi 1 e. Ces taches se chargent de compiler les classes 
et de les placer dans les repertoires classes de chaque projet. Pour sup- 
primer tous les repertoires de travail (build et classes), on peut utiliser 
les taches barkbank-clean et petex-clean. 



Ant Les taches 
dans build. xml et admin. xml 

Les fichiers contenant les taches Ant (build.xml et 
admin.xml) sont decrits en annexe et telechargea- 
bles sur le site : 

► http://www.antoniogoncalves.org 



Packager 

Les services de verification de la BarkBank et de transport PetEx sont 
chacun packages dans une application web. Les archives contiennent les 
classes des services web mais aussi tous les artefacts serveurs generes par 
wsgen (les classes et les fichiers WSDL et XSD). Pour ce faire, on exe- 
cute les taches barkbank-build et petex-build. Les archives 
barkbank.war et petex.war sont places dans le repertoire build. 



tjbarkbank.war C3 petex.war 

Figure 9-13 7 6; ValidationService Figure 9-14 i)~5j]DeliveryService 

Contenu de I'archive 1™!™*''°" Contenu de I'archive ^ c ■ Delivery 

.... th WEB-INF E9 WEB-INF 

barkbank.war L^j web , xm | petex.war L^ webxm | 
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(3lpetstore.ear 
lib 

9 utility jar 
3 ws-mterface iar 
^ entity jar 
L E§ persistence.xml 

- ^stateless jar 

- %stalefuljar 
(3 petstorewar 

t E9 WEB-INF 

ti2? faces-config.xml 
S web.xml 



Figure 9-15 Contenu du fichier petstore.ear 



Ant Deploy, undeploy 

Une fois les applications deployees a I'aide des 
taches depl oy, on peut les supprimer du serveur 
GlassFish en utilisant les taches suivantes : 

• yaps-undeploy ; 

• barkbank-undeploy ; 

• petex-undeploy. 



Pour generer les artefacts client pour l'application YAPS Pet Store, il est 
imperatif que les services web soient deployes. Ensuite, il suffit d'exe- 
cuter la tache yaps-build qui se chargera de generer les artefacts (avec 
ws import) et de packager la totalite des classes dans le fichier 
petstore.ear. Les artefacts des deux services web se trouvent dans le 
fichier ws-i nterface .jar qui se trouve dans le sous-repertoire 1 i b. 

Deployer 

Comme toujours pour le deploiement, il faut s'assurer que le serveur 
GlassFish et la base de donnees Derby soient demarres. Si ce n'est pas le 
cas, utilisez les taches Ant d'administration : 

%PETSTORE_HOME%\> ant -f admin. xml start-domain 
%PETSTORE_HOME%\> ant -f admin. xml start-db 

Chaque application est packagee dans un fichier d'archive different et 
doit etre deployee separement. Pour cela, utilisez les taches Ant petex- 
deploy, barkbank-deploy et yaps-deploy. Vous pouvez ensuite acceder 
individuellement a chacune d'elle en utilisant des URL differentes : 

• http://localhost:8080/petstore 

• http://localhost:80807barkbank 

• http://localhost:80807petex 



Tester les services web avec GlassFish 

Une fois les applications deployees, vous pouvez utiliser le mecanisme de 
GlassFish pour tester les services web. Par exemple, pour tester le service 
de validation de BarkBank, il suffit de vous rendre a l'adresse suivante : 
http : //! ocal host : 8080/barkbank/Val i dati onSe rvi ce?Tester. 



Figure 9-16 

Page permettant de tester 
le service de validation 



ValidationService Web Service Tester - Mozilla Firefox 






Fichier Edition Affichage Historique Marque-pages Outils ? |G|t 






ValidationService Web Service Tester 






This form will allow' vou to test vour web senice implementation ftt'SDL File) 






To invoke an operation, fill the method parameter(s) input boxes and click on the button labeled with the method name. 



Methods : 

public abstract java.lang. String com.barkbank.vaKdatorA"aKdation.\aKdateCard(ja\a.lang.StringJa\a_lang.StringJa\a_lang 
I validateCard I ((123 



I J10/10I 
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II est alors possible de saisir les parametres que Ton souhaite et invoquer le 
service web. Par exemple, dans l'ecran precedent (figure 9-16), vous 
pouvez saisir un numero impair pour une carte Visa. Lorsque vous cliquez 
sur le bouton validateCard, le service est invoque et le resultat s'affiche 
dans la page ci-apres (figure 9-17), vous indiquant que le numero de la 
carte est errone car impair ( Visa card number has to be evert). 



Remarque Le message Soap 



La page de resultat du service web affiche aussi la 
requete et la reponse de la methode au format 
Soap. Cela permet de voir ce qui est cree automati- 
quement sans que nous n'ayons eu a manipuler les 
messages Soap directement. 



9 Method invocation trace • Mozilla Firefox 



Fichier Edition Affichage Historique Marque-pages Outils ? 

\ alidateCard Method invocation 



antonio.goncalves 



Method parameter(s) 



Type 


Value 


|java.lang.Stri 


ig 123 


java lang Strii 


ig Visa 


javatang. String 10 10 



Method t 

java lang String : "Visa card number has to be even" 



Figure 9-17 

Page de resultat du service web 



Pour consulter le contenu du document WSDL vous pouvez aussi vous 
rendre a l'adresse suivante : 

http : //! ocal host : 8080/barkbank/Val i dati onServi ce?WSDL. 



Executer 



Pour verifier que tout cela fonctionne, il suffit d'utiliser l'application YAPS 
Pet Store pour acheter des articles. Au moment de valider le panier elec- 
tronique, vous pouvez saisir un mauvais numero de carte bancaire, par 
exemple, et verifier que le statut s'affiche a l'ecran (figure 9-18). 

Saisissez maintenant des donnees correctes. Cela a pour effet de creer un 
bon de commande et d'avertir le transporteur PetEx via son service web. 
Pour verifier que le service a bel et bien ete invoque, consultez les logs du 
serveur GlassFish. Vous pouvez ainsi voir l'appel au service Del i very. 



GLASSFlSH Consulter les logs 



Pour lire les logs du serveur GlassFish vous pouvez, 
soit consulter le fichier %GLASSFISH_HOME%\ 
domai ns\petstore\logs, soit vous con- 
necter a la console d'administration. Pour cela, 
allez a l'adresse http: //local host: 8282 
puis saisissez le nom de I'utilisateur admi n et son 
mot de passe adminpwd. Cliquez sur le menu 
Application Server -> View Log Files. 
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- Confirm Order - Mozilla firefox 



Figure 9-18 

Un message s'affiche indiquant 
que le numero est invalide. 



rtdw Cdbon Afffchoge Metonque Marque-pages Outfe I [G]' 



Birds 
Cats 
lings 
Fish 

Reptiles 



Confirm Order 



Gedil Cdid ib invalid : Vibd (.did number lidb Lu be even 



Personal information 



Firqrnsmp : Steve 
Lastname : Jubb 

Enidil : steve.jobs@apple.coi 



Delivery Address 



"Strcctl : 151 Star Boulevard 
Street2 : 



-t iry : San Francisco 
Sidle ; 



wc 



"Zipcode : 5455 



-Country : USA 



Credit Card 



-Credit rard number : l^j 
-Type : 



Visa 



-Expiry date (MM/YY); 10/10 



Extrait des logs du serveur GlassFish 

com.petex.transport|De"livery Order Received 

com.petex.transport|De"liver from De"liveryP1ace{contact='Yaps 
Inc.', street='125, Poodle Square', city='San Francisco', 
state='LA', zipcode='16354' , country^' USA' } 



com. petex. transport | Deliver to Del iveryP1ace{contact=' Jobs' , 
street='154 Star Boulevard', city='San Francisco', state='WC, 
zipcode=' 5455' , country=' USA' } 



com . petex . transport | Reference n° 101 
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En resume 



Les clients peuvent maintenant acheter des animaux en ligne. Notre appli- 
cation a done besoin de communiquer avec des systemes externes pour 
verifier la validite des cartes bancaires ainsi que pour avertir le transporteur 
de nouvelles livraisons. Ces traitements B2B se font via l'echange de don- 
nees au format XML. Ce chapitre nous a presente les services web et les 
differentes API sous-jacentes a cette technologic Java EE 5 et la genera- 
tion d'artefacts simplifient grandement le developpement des web services. 



chapitre 





Traitements asynchrones 



SOMMAIRE 

Lorsque le bon de commande est cree, le systeme doit 
l'imprimer et envoyer au client un e-mail lui confirmant 
ses achats. Ces traitements pouvant etre longs, ils sont 
effectues de maniere asynchrone via un systeme d'echange 
de messages. Ce chapitre nous presente les technologies JMS, 
MDB ainsi que l'API JavaMail. 

MOTS-CLES 

► JMS 

► MOM 

► MDB 

► Point a point 

► Publication/abonnement 

► JavaMail 



► Traitements asynchrones 

► Envoi d'un e-mail 
de confirmation 

► Impression du bon 
de commande 

► JMS 

et les message-driven beans 

► Cycle de vie des MDB 



//. Synchrone/Asynchrone 

• Synchrone : echange ou traitement d'informa- 
tions en direct (appel bloquant). 

• Asynchrone : echange ou traitement d'informa- 
tions en differe. 



Retour d'experience Les Threads dans Java EE 

Pour effectuer un traitement asynchrone en Java, 
on peut utiliser I'API des Threads. En effet, il suffit 
a une classe serveur de creer un nouveau Thread 
par traitement demande. Cette API s'est enrichie 
et simplifiee avec Java SE 5. Malheureusement, les 
specifications Java EE interdisent I'utilisation de 
Threads dans les EJB car ce travail doit etre fait par 
le conteneur et non par le developpeur. II est done 
proscrit d'utiliser les Threads dans un environne- 
ment Java EE. 



APPROFONDIR JMS 

(D Eric Bruno, Java Messaging, Charles River, 
2005 

CD Richard Monson-Haefel, Java Message 

Service, O'Reilly, 2002 
CD Kareem Yusuf, Enterprise Messaging 

Using JMS and IBM Websphere, IBM 

Press, 2004 
► http://java.sun.com/products/jms/ 



OuilLS Providers JMS 

IBM WebSphere MQ 

► http://www-306.ibm.com/software/ 
integration/wmq/ 

JBoss MQ (bientot remplace par JBoss Messaging 
dans JBoss AS 5.0) 

► http://www.jboss.org/wiki/ 
Wiki.jsp?page=JBossMQ 

Sonic MQ 

► http://www.sonicsoftware.com/products/ 
sonicmq 

Sun OpenMQ 

► http://www.sun.com/software/products/ 
message_queue/index.xml 



Lorsque le client valide son panier electronique et qu'il saisit son adresse 
de livraison ainsi que ses coordonnees bancaires, le systeme cree un nou- 
veau bon de commande. Au meme moment, il envoie un e-mail de con- 
firmation au client lui detaillant le contenu de sa commande, et imprime 
le bon de commande pour pouvoir etre archive par le service comptable. 

L'impression et l'envoi de l'e-mail peuvent s'averer etre des traitements 
longs. Imaginez que l'imprimante soit debranchee, quelle manque de 
papier ou que l'adresse e-mail soit erronee ou le pare-feu en panne. Pour 
toutes ces raisons, il est preferable d'effectuer ces traitements de maniere 
asynchrone. La creation du bon de commande dans le systeme peut se 
faire sans attendre que l'impression soit effectuee. 

Dans le meme esprit, les employes de YAPS doivent etre avertis en 
temps reel de la creation d'un bon de commande contenant des reptiles. 
Ces alertes se font par envoi de messages et sont affichees sur 1'IHM des 
employes. Si les employes ne sont pas connectes a leur application, les 
alertes doivent etre empilees jusqu'a ce qu'ils se reconnectent. 

Ce chapitre couvre les fonctionnalites restantes du cas d'utilisation 
« Creer un bon de commande ». 

JMS 

JMS, ou Java Message Service, est une API d'echange de messages pour 
permettre un dialogue entre applications via des brokers de messages ou 
MOM {Middleware-Oriented Messages). L' application cliente envoie un 
message dans une file d'attente (plutot qua une application, ce qui 
permet de faire du decouplage logiciel), sans se soucier de la disponibilite 
de cette application (chaque systeme possede son propre cycle de vie). 
Le client a, de la part du broker de messages, une garantie de qualite de 
service (certitude de remise au destinataire, delai de remise, etc.). 

LAPI JMS, contenue dans le paquetage javax.jms, definit plusieurs 
entites : 

• Un provider : outil (broker de messages) qui implemente 1API JMS 
pour echanger les messages entre deux clients. Le serveur GlassFish 
utilise l'implementation Sun Java System Message Queue 
(OpenMQ). 

• Un client : classe Java qui utilise JMS pour emettre et/ou recevoir des 
messages. Un client envoie un message vers une file d'attente, et le 
client destinataire reste a l'ecoute d'une file d'attente pour recevoir le 
message. Le transfert du message et sa persistance sont assures par le 
provider. 
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• Un message : donnees echangees de maniere asynchrone entre les com- 
posants. II existe plusieurs types de messages (texte, objet, binaire, etc.). 

• Les objets administres : ressources a rechercher dans l'annuaire JNDI 
du provider, telles que les fabriques de connexions et les destinations. 

Les messages 

Pour dialoguer, les clients JMS s'echangent des messages, c'est-a-dire 
qu'un client expedie un message vers une file d'attente, et qu'un client 
destinataire execute un traitement a la reception de ce message. En JMS, 
ces messages doivent implementer l'interface javax.jms. Message et sont 
composes de trois parties : 

• l'en-tete (header), qui comporte des caracteristiques techniques 
(identifiant, date d'envoi, etc.) ; 

• les proprietes (properties), qui representent les caracteristiques fonc- 
tionnelles du message ; 

• le corps du message (body), qui contient les donnees a transporter. 



- 

En-tete 


Proprietes 


Corps 


JMSMessagelD 




BytesMessage 


JMSCorrelationID 




TextMessage 


JMSDeliveryMode 




ObjectMessage 


JMSDestination 




MapMessage 


JMSExpiration 




StreamMessage 


JMSPriority 






JMSRedelivered 






JMSReplyTo 






JMSTimestamp 







Figure 10-1 

Anatomie d'un message JMS 



L'en-tete du message 

L'en-tete du message contient un certain nombre de champs predefinis 
permettant de l'identifier. On peut voir cette section comme les meta- 
donnees du message : qui a cree le message, date de creation, duree de 
vie, accuse de reception demande ou non, etc. Chacune de ces metadon- 
nees possede des accesseurs (definis dans l'interface javax.jms. Message) 
qui permettent d'en modifier le contenu, mais la plupart sont affectees 
automatiquement par le provider. 
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Tableau 10-1 Metadonnees de I'en-tete 



Norn 


Description 


JMSMessagelD 


Identifiant unique du message. 


JMSCorrelationID 


Utilise pour associer de facpn applicative deux messages par leur identifiant. 


I Mortal iv/prvMnrlo 
JivUL/ciivciyiviuuc 


II pyktp Hpi iy mnrlpc rl'pn\/ni ■ nprcktant Hp mp<;<;arip pet rlpliwrp i inp pt i inp qpi iIp fnic ai i rlpctinstairp r'pct-3-rlirp 

II CAI3LC UCUA IMUUCJ U CIIVUI . [JCI J I i Ld I I L \\C MICiidyC CiL UCIIVIC UIIC CL UIIC SCUIC IUID dU UC3 II I Id Id 1 1 C, L CUL d UIIC 

que meme en cas de panne du provider, le message sera delivre) et non persistant (le message peut ne pas etre 
delivre en cas de panne puisqu'il n'est pas persiste). 


JMSDestination 


File d'attente destinataire du message. 


JMSExpiration 


Date d'expiration du message. 


JMSPriority 


Priorite du message. Cet attribut numerique indique la priorite de facon croissante a partir de 0 (les messages de 
niveau 9 ont une priorite plus importante que les messages de niveau 0). 


JMSRedelivered 


Booleen qui signifie que le message a ete redelivre au destinataire. 


JMSReplyTo 


File d'attente de reponse du message. 


JMSTimestamp 


L'heure d'envoi du message est affectee automatiquement par le provider. 




Les proprietes 

Cette section du message est optionnelle et agit comme une extension des 
champs d'en-tete. Les proprietes d'un message JMS sont des couples 
(nom, valeur), ou la valeur est un type de base du langage Java (entiers, 
chaines de caracteres, booleens, etc.). L'interface javax.jms. Message 
definit des accesseurs pour manipuler ces valeurs. Ces donnees sont gene- 
ralement positionnees par le client avant l'envoi d'un message et, comme 
nous le verrons par la suite, peuvent etre utilisees pour filtrer les messages. 




Le corps du message 

Le corps du message, bien qu'optionnel, est la zone qui contient les don- 
nees. Ces donnees sont formatees selon le type du message qui est defini 
par les interfaces suivantes : 




Tableau 10-2 Types de messages 




javax.jms.BytesMessage 


Pour les messages binaires (images, videos, documents electroniques...). 


javax.jms.TextMessage 


Echange de donnees de type texte (XML par exemple). 


javax.jms.ObjectMessage 


Messages composes d'objets Java serialises. 


javax.jms.MapMessage 


Echange de donnees sous la forme cle/valeur. La cle doit etre une String et la valeur de type primitif. 


javax.jms.StreamMessage 


Echange de donnees en provenance d'un flux. 



II est possible de definir son propre type de message en implementant 
l'interface mere javax. jms .Message. Lors de la reception d'un message, 
celui-ci est toujours de type javax . jms . Message Q. II doit done etre trans- 
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type © en fonction de son type. Loperateur i nstanceof Q est alors utilise 
pour detecter le type exact du message. A ce moment, il faut utiliser le 
getter Q correspondant pour obtenir les donnees (ObjectMessage. 
getObject() ,TextMessage.getText(), etc.). 

Exemple de transtypage d'un message 

public void onMessage(javax. jms. Message Q message) { 
if (message i nstanceof @ ObjectMessage) { 

ObjectMessage objMsg = (ObjectMessage) message; Q 
objMsg.getObjectO ; O 

} 

} 

Les objets administres 

On nomme ces objets « administres » car ils doivent etre auparavant crees 
et configures de maniere administrative, via une console ou par script. 

Dans 1'utilisation de l'API JMS, deux types d'objets sont geres differem- 
ment des autres : 

• Les fabriques de connexions (ConnectionFactory) permettent 
d'obtenir une connexion aupres d'un provider. 

• Les destinations sont les objets qui vehiculent les messages. JMS 
comporte deux types de destinations, les Queue et les Topi c. 

Pour obtenir une ConnectionFactory, une Queue, ou un Topic, il faut les 
rechercher par leur nom dans l'annuaire JNDI ou utiliser i'injection. 
Cela suppose done que ces objets aient ete prealablement inscrits dans 
JNDI. C'est ce que nous avons fait dans le chapitre 3, Outils et installa- 
tion, lorsque nous avons configure GlassFish. 

La fabrique de connexions 

Dans JMS, la fabrique de connexions (ConnectionFactory) permet 
d'obtenir une connexion au provider (Sun Java System Message Queue 
dans le cas de GlassFish). Une fois la connexion obtenue, on peut 
envoyer ou recevoir des messages. Comme nous le verrons plus bas, 
l'objet ConnectionFactory permet d'obtenir les objets Connection, 
Session puis les objets pour produire (MessageProducer) et consommer 
(MessageConsumer) des messages. 

Dans les chapitres precedents, nous avons utilise l'annotation @EJB pour 
injecter les references de nos stateless session beans. Cette annotation est 
propre aux EJB. Pour la fabrique de connexions, nous utiliserons l'anno- 
tation plus generique @javax. annotation. Resource. 



Remarque La fabrique et la destination JMS 

Lors de la configuration du serveur GlassFish, nous 
avons cree une fabrique de connexions (jms/ 
petstoreConnectionFactory) ainsi qu'une 
file d'attente (jms/topi c/order). 
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Annotation [.'injection avec ©Resource 

L'annotation ©Resource permet d'injecter la 
reference d'une ressource dans un attribut de 
classe. Dans nos exemples, nous I'utilisons pour 
referencer des destinations ou fabriques de con- 
nexions JMS. Mais la meme annotation peut etre 
utilisee pour referencer une DataSource, un pool 
de connexions JDBC, ou tout autre objet declare 
dansJNDI. 



Cette annotation s'applique a une classe, une 
methode ou un attribut. 



Nom de la ressource JNDI. 
Classe de la ressource 

(ex. javax . sql . DataSource pour une 
source de donnees). 

Informe le serveur du composant responsable de 
I'authentification pour acceder a la ressource : le 
conteneur ou I'application. 

Ressource partageable ou non. 

Cet attribut represente le nom donne a la res- 
source a I'interieur du conteneur. II est specifique 
a chaque serveur d'applications et peut done ne 
pas etre portable. 

Description de la ressource. 



Injection de la fabrique de connexions 

@Resource(mappedName = " jms/petstoreConnectionFactory") 
private ConnectionFactory connectionFactory ; 

©Resource permet d'injecter des ressources externes, dans notre cas la 
fabrique de connexions. 

Code de l'annotation @javax.annotation. Resource 

I package javax. annotation; 

► ©Target ({TYPE, FIELD, METHOD}) ©Retention (RUNTIME) 

public ©interface Resource { 

► String name() default ""; 

► Class type() default Object. class 

► AuthenticationType authenticationType() default CONTAINER; 

► boolean shareable() default true; 

► String mappedName() default ""; 

► String description() default ""; 
} 

Destinations 

JMS definit deux types de destinations correspondant aux deux modes 
d'envoi des messages : 

• Le mode point a point (Point to Point) utilise des files d'attente 
(javax. jms. Queue) pour communiquer. Ce mode (un emetteur, un 
recepteur) s'apparente a l'envoi d'un e-mail. 

• Le mode publication/abonnement (Publish/Subscribe) utilise des 
sujets (javax. jms. Topic) pour echanger des messages. Ce mode (un 
emetteur, multiples recepteurs) correspond, par exemple, a une sous- 
cription aupres d'un serveur de news. Par defaut, seuls les recepteurs 
connectes au Topi c sont alertes de l'arrivee du message. Pour que les 
messages soient conserves pour les recepteurs deconnectes, ils doi- 
vent avoir ete declares comme durables. 
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Chaque mode utilise une interface differente pour envoyer des 
messages: javax. jms .QueueSender dans le mode point a point, et 
javax. jms. Topi cPublisher pour le mode publication/abonnement. 
Toutes deux heritent de la super interface javax. jms. MessageProducer. 

Pour referencer un Topic, par exemple, on utilise le systeme d'injection 
de l'annotation ©Resource. 

Injection de la destination 

@Resource(mappedName = " jms/topic/order") 
private Topic destinationOrder; 

Le mode point a point 

Le mode point a point repose sur le concept de files d'attente (Queue). 
Cela signifie que chaque message est envoye par un producteur dans une 
file d'attente, et est recu par un seul consommateur. Une fois le message 
consomme, il disparait de la file d'attente. 




Figure 10-2 

Producteur Consommateur Mode point a point 

Bien entendu, tant que le message nest pas consomme, ou qu'il n'a pas 
expire, il reste stocke au sein du provider. Le client peut done le con- 
sommer ulterieurement. 

II peut arriver aussi que le consommateur du message Fait recu par 
erreur, ou qu'il ne puisse pas le traiter immediatement. Dans ce cas, il 
peut annuler la reception du message en effectuant un rollback. 

Le mode publication/abonnement 

Le mode publication/abonnement repose sur le concept de sujets 
(Topics). Cela signifie que des messages sont envoyes par plusieurs pro- 
ducteurs dans un Topic, et qu'ils sont recus par plusieurs consomma- 
teurs. Les consommateurs des messages s'abonnent aux sujets qui les 
interessent : e'est le principe de l'abonnement. Lemetteur du message ne 
connait pas les destinataires qui se sont abonnes. 

Contrairement au mode point a point, dans le mode publication/abon- 
nement un message envoye va etre recu par plusieurs clients. 
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Figure 10-3 

Mode publication/abonnement 




Consommateurs 



Transaction jms 



Dans le cas d'une session transactionnelle 
(connection . createSession(true)), 
I'envoi de messages n'est effectivement realise 
qu'au moment de I'execution du commit de la 
transaction. 



Envoyer les messages 

Voyons maintenant comment utiliser tous ces concepts pour publier un 
message dans un Topic. Comme nous l'avons vu, la fabrique de con- 
nexions et la destination doivent etre connues par les clients JMS. Pour 
cela, nous utilisons l'annotation @javax. annotation. Resource qui 
permet d'injecter la reference de la fabrique JMS que nous avons creee 
dans GlassFish 0, ainsi que la destination jms/topi c/order 0. 

Une fois la reference de la ConnectionFactory obtenue, on se connecte 
au provider JMS via l'objet javax. jms. Connection 0. A partir de cette 
connexion, on obtient une session 0. Une Session est un contexte tran- 
sactionnel utilise pour grouper un ensemble d'envois de messages (ou de 
receptions de messages) dans une unite de travail. Comme avec les bases 
de donnees, une session transactionnelle n'est validee qu'apres appel 
implicite ou explicite d'un ordre commit. 

A partir de la session, on cree un MessageProducer 0 qui va permettre 
d'envoyer 0 un message aupres d'une destination. La session permet 
aussi de creer le message 0 (de type objet dans notre exemple). 
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Envoi d'un message 

public class OrderBean implements OrderRemote , OrderLocal { 

@Resource(mappedName = "jms/petstoreConnectionFactory") Q 
private ConnectionFactory connectionFactory ; 
@Resource(mappedName = " jms/topi c/order") Q 
private Topic destinationOrder; 

private void publ i sh0rder(0rder order) { 

Connection connection = 0 

connectionFactory . createConnecti on () ; 

Session session = connection. createSession(true, 

Session.AUTO_ACKNOWLEDCE) ; Q 

MessageProducer producer = 

session. createProducer(desti nationOrder) ; 0 

ObjectMessage objectMessage = 

session. createObjectMessage() ; 0 
objectMessage . setObject (order) ; 

producer. send(objectMessage) ; Q 

session . close() ; 
connection.close() ; 



Injection de la fabrique de connexions et du 
Topi c qui sont declares dans GlassFish. 



On se connecte au provider de messages. 



Le premier parametre true signifie que la ses- 
sion est transactionnelle. 



On cree un MessageProducer, qui dans 
notre cas sera un Topi cPubl i sher. 



On cree un message de type objet. On affecte au 
corps du message I'entity bon de commande. 



Le message est envoye dans le Topi c. 



On referme la session et la connexion. 



Recevoir un message 

Le consommateur du message est le client capable d'etre a l'ecoute d'une 
file d'attente (ou d'un Topic), et de traiter les messages a leur reception. 
Si on ne veut pas bloquer le consommateur, le mecanisme d'ecoute doit 
etre fait dans un Thread a part. En effet, le client doit etre constamment 
a l'ecoute (listener) et, a l'arrivee d'un nouveau message, il doit pouvoir le 
traiter. Pour cela, le Thread doit appeler la methode onMessage de 
l'interface javax. jms.MessageListener. Celle-ci permet la reception 
asynchrone des messages et ne dispose que d'une methode dont la signa- 
ture est la suivante : 

| public void onMessage(javax . jms . Message message); 

Charge au developpeur d'implementer cette interface pour realiser le 
traitement adequat lors de la reception d'un message. 

Prenons l'exemple du client Swing de l'application. Celui-ci doit etre a 
l'ecoute des nouvelles commandes qui sont publiees dans le Topic "jms/ 
topic/order". Lorsque le message contenant le nouveau bon de com- 
mande arrive, ses informations sont affichees a l'ecran. 
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Annotation ©Resource dans le client Swing 

Souvenez-vous que pour des raisons pedagogiques 
I'interface Swing ne s'execute pas dans un conte- 
neur client (Application Client Container). Si 
tel avait ete le cas, nous aurions pu utiliser I'anno- 
tation ©Resource pour injecter les references de 
la fabrique de connexions et de la destination JMS 
et ainsi s'affranchir de JNDI. 



JMS Acquittement de message 

Lorsqu'on cree une session, on peut specifier le mode 
d'acquittement des messages. II en existe trois : 

• acquittement automatique 
(Session .AUTO_ACKNOWLEDGE); 

• acquittement fait par le client 
(Session . CLIENT_ACKNOWLEDGE); 

• duplication des acquittements toleree 
(Session . DUPS_OK_ACKNOWLEDGE). 



[.'injection n'est pas utilisee. ► 



On recherche la fabrique de connexions et le ► 
Topic declares dans I'annuaire JNDI de I'ins- 
tance Glassfish. 



On se connecte au provider de messages. ► 



Le premier parametre true signifie que la ► 
Session est transactionnelle. 

On cree un MessageProducer, qui dans ► 
notre cas sera un Topi cPubl i she r. 

On associe un listener a la classe. ► 

On demarre la connexion. ► 



Les messages arrivent par la methode ► 
onMessage. 



Pour effectuer cette tache, le client a tout d'abord besoin d'implementer 
I'interface MessageListener Q. II doit ensuite obtenir la fabrique de con- 
nexions et la destination JMS 0 sur lesquelles il souhaite ecouter 
l'arrivee des nouveaux messages. L'application Swing s' executant en 
dehors d'un conteneur, il nous faut utiliser l'API JNDI pour obtenir les 
references ©. 

Tout comme pour l'envoi d'un message, le consommateur doit se connecter 
au provider via l'objet j avax . j ms . Connecti on © pour en retour obtenir une 
session ©. A partir de la session, on cree un MessageConsumer © qui va 
permettre de consommer les messages. Pour ce faire, on associe un listener 
pour traiter les messages de facon asynchrone ©. Ainsi, a chaque reception 
d'un nouveau message, la methode onMessage est automatiquement invo- 
quee © et peut effectuer un traitement. 

Reception d'un message 

i public class YapsMsgLi stener implements MessageListener {© 

private ConnectionFactory connectionFactory; © 
private Topic desti nati onOrder ; 

private void recei veOrder(Order order) { 

// Pour simplifier la lecture du code, la reception 

// asynchrone a l'aide d'un thread n'est pas implemented 

InitialContext ic = new InitialContextO ; © 
connectionFactory = (ConnectionFactory) 

ic.lookupC'jms/petstoreConnecti on Factory") ; 
destinationOrder = (Topic) 

ic.lookupC'jms/topic/order") ; 

Connection connection = © 

connectionFactory . createConnecti on () ; 

Session session = connection. createSession(true, 

Session .AUTO_ACKNOWLEDGE) ; © 

MessageConsumer consumer = 

session. createConsumer(desti nationOrder) ; © 

consumer. setMessageLi stener(thi s) ; © 

connection. start() ; 

} 

public void onMessage(Message message) { © 
if (message instanceof ObjectMessage) { 

ObjectMessage objMsg = (ObjectMessage) message; 
tableModel .add(objMsg.getObjectO) ; 

} 

} 

} 
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La selection de messages 

Pour les clients qui ne seraient pas interesses par tous les messages arri- 
vant dans une file d'attente, JMS permet de les filtrer. Ce filtrage est 
effectue par le provider de messages plutot que par l'application elle- 
meme. Ainsi, selon certains criteres, le client ne recevra que les messages 
qui l'interessent. Les criteres de selection ne peuvent porter que sur des 
champs inclus dans l'en-tete ou dans les proprietes du message. II n'est 
pas possible d'utiliser les donnees du corps pour effectuer le filtre. 

Cette possibilite de filtrer les messages se fait par le consommateur qui 
utilise un selecteur de type SQL. Cette chaine de caracteres permet de 
ne selectionner que les messages dont les champs d'en-tete et les pro- 
prietes presentent certaines caracteristiques. 

Exemple de filtres JMS 

'JMSPriority > 6" 

'JMSPriority > 6 And Orderld < 100" 

'JMSPriority > 6 And Orderld < 100 Or Repti 1 es=true" 

Reprenons l'exemple de l'interface Swing. Les employes ne sont en realite 
interesses que par les commandes contenant des reptiles. Pour cela, le pro- 
ducteur du message rajoute une propriete Repti 1 es Q de type booleen qu'il 
positionne a « vrai » lorsque qu'une commande contient au moins un reptile. 

Le producteur du message rajoute la propriete Reptiles 

ObjectMessage objectMessage = session. create0bjectMessage() ; 
objectMessage. setObject (order) ; 

objectMessage. setBooleanProperty("Reptiles", true); Q 

producer. send(objectMessage) ; 

Le consommateur, lui, utilise un selecteur 0 pour ne recevoir que les 
messages possedant une propriete ayant le nom de Reptiles avec une 
valeur a true. La session permet de preciser dans ces parametres une 
chaine de caracteres qui va servir de filtre sur les messages a recevoir. 

Le consommateur utilise un selecteur sur les proprietes 

Session session = connection. createSession(true, 

Session. AUT0_ACKN0WLEDCE) ; 

MessageConsumer consumer = Q 

session . createConsumer (des ti nationOrder, "Repti 1es=t rue") ;Q 
consumer . setMessageLi stener(thi s) ; 



JMS Selection sur l'en-tete 

JMS permet de faire une selection sur les champs de 
l'en-tete JMSDeliveryMode, JMSPriority, 
JMSMessagelD, JMSCorrelationID, JMSType 
et JMSTimestamp. Celle-ci n'est pas possible pour 
JMSDestination, JMSReplyTo, JMSExpi ration 
ou JMSRedelivered. 



Recoit les messages de priorite superieurs a 6. 
JMSPriori ty est un champ de l'en-tete. 



Recoit les messages de priorite superieurs a 6 et 
ayant une propriete Orderld inferieure a 100... 



. ou une propriete Repti 1 es a vrai. 



Le producteur cree un message de type objet et 
affecte un bon de commande dans le corps du 
message. 



On rajoute une propriete de type booleen 
laquelle le filtrage s'effectuera. 



sur 



Le message est envoye. 



Le consommateur ne recevra que les messages 
dont la propriete Repti 1 es est « vrai ». 
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Approfondir mdb 



(D Ed Roman, Rima Patel Sriganesh, Gerald 
Brose, Mastering Enterprise JavaBeans, 
3rd Edition, Wiley, 2004 

► http://java.sun.eom/javaee/5/docs/tutorial/ 
doc/ 



Syntaxe Classe EJB 



La classe de I'EJB doit suivre les regies de develop- 
pement suivantes : 

• elle doit etre annotee par 
OMessageDri ven ; 

• elle doit etre publique ; 

• elle ne doit pas etre finale ; 

• elle ne doit pas etre abstraite ; 

• elle ne doit pas definir la methode 
fi nal ize ; 

• elle doit avoir un constructeur par defaut ; 

• elle doit implementer les methodes de ses inter- 
faces. 



Un MDB est defini comme tel grace a I'annota- 
tion @MessageDri ven. 



Point d'entree du MDB. 



On transtype le message en ObjectMessage. 



On recupere le bon de commande qui se trouve 
dans le corps du message. 



Message-driven bean 



Un message-driven bean, ou MDB, est un EJB qui se comporte comme 
un listener JMS, e'est-a-dire qui recoit des messages et les traite de 
maniere asynchrone. Les MDB se rapprochent des EJB stateless car ils 
sont, eux aussi, sans etat. Ils s'executent a l'interieur d'un conteneur qui 
assure le multithreading, la securite ou la gestion des transactions. 

Les MDB sont a l'ecoute (listener) d'une file d'attente et se reveillent a 
chaque arrivee de messages. En fait, il faut garder a l'esprit que e'est le 
conteneur qui est le veritable listener JMS et qu'il delegue au MDB le 
traitement du message, et plus particulierement a la methode 
onMessage(). Comme les autres EJB, le MDB peut acceder a tout type 
de ressources : EJB, JDBC, mail, etc. 

Exemple de message-driven bean 

Un MDB ne possede pas d'interface distante ou locale puisqu'il n'est pas 
utilise par un client. II est constitue d'une seule classe Java qui doit etre 
annotee par Ojavax.ejb.MessageDriven O- Pour reagir a 1' arrivee d'un 
message, il doit implementer la methode onMessage(javax. jms. 
Message)© definie dans l'interface javax. jms.MessageListener Q. II 
est associe a une destination JMS, e'est-a-dire une Queue pour les com- 
munications point a point ou a un Topic pour les communications publi- 
cation/souscription. La methode onMessage est activee a la reception 
d'un message envoye par un client JMS. 

Classe du message-driven bean 
@MessageDriven(mappedName = " jms/topic/order") Q 

public class OrderPri nterBean implements MessageLi stener Q{ 

public void onMessage(Message message) { Q 

if (message instanceof ObjectMessage) { 

ObjectMessage msg = (ObjectMessage) message; 

Order order = (Order) msg . getObject() ; 
pri ntOrder (order) ; 



// gestion des exceptions 



} 
} 

Comme la plupart des composants specifies dans Java EE 5, les mes- 
sage-driven beans utilisent, eux aussi, les annotations. 
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Code de I'annotation @javax.ejb.MessageDriven 

package javax.ejb; 
©Target ({TYPE}) ©Retention (RUNTIME) 
public ©interface MessageDriven { 
String name() default ""; 

Class messageLi stenerlnterface() default Object . cl ass ; 

ActivationConfigProperty[] activationConfigO default {}; 
String mappedName() default ""; 

String description() default ""; 

} 

Les MDB peuvent etre a l'ecoute de messages arrivant de differents 
types de providers. Pour cela, I'annotation ©javax.ejb. MessageDriven 
permet au MDB de configurer certains parametres de ses providers. II 
suffit d'utiliser le tableau activationConfig comme suit : 

Exemple de configuration de MDB 

©MessageDriven (mappedName = " jms/topi c/order" , 
activationConfig = { 

@ActivationConfigProperty(propertyName = "desti nati onType" , 

Q propertyVal ue = "javax. jms. Topic") , 
@ActivationConfigProperty(propertyName = 

"subscri pti onDurabi 1 i ty" , 
Q propertyVal ue = "Durable"), 
@ActivationConfigProperty(propertyName = "subscri ptionName" , 

propertyVal ue = "Emai 1 Sender") 

} 

) 

public class Emai 1 SenderBean implements MessageLi stener { 
(...) 

} 

Dans cet exemple, on utilise I'annotation ©ActivationConfigProperty 
pour specifier le type de la destination Q ou la persistance des messages Q. 
©javax.ejb. ActivationConfigProperty est constitute de cles et devaleurs 
permettant une configuration plus fine d'un MDB. 

Code de I'annotation @javax.ejb.ActivationConfigProperty 

package javax.ejb; 

@Target({}) ©Retention(RUNTIME) 



Cette annotation s'applique a une classe. 



Norn du MDB. 



Le type d'interface implemented par le MDB 
peut etre defini par cet attribut 
(MessageLi stener dans notre exemple). 



Permet de configurer le MDB. 

Nom JNDI de la destination sur laquelle le MDB 
est a l'ecoute. 



Description du message-driven bean. 



MDB Implementer MessageListener ? 

La specification Java EE 5 est assez vague sur 
I'obligation d'implementer I'interface Message 
Li stener ou non. Dans un chapitre, on nous dit 
qu'il n'est pas necessaire pour un MDB de I'imple- 
menter, et dans un autre, on nous dit presque le 
contraire. Avec ('implementation GlassFish, pour 
qu'un MDB soit reconnu comme tel, il lui faut juste 
utiliser I'annotation ©MessageDriven. Pas 
besoin d'implementer une quelconque interface. 
J'ai neanmoins laisse cette interface dans les 
exemples de code de ce chapitre. 



Cette annotation 
©MessageDriven. 



s'applique 
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Cle de la propriete. 



Valeur de la propriete. 



public ©interface ActivationConfigProperty { 

String propertyNameO ; 
String propertyVal ue() ; 

} 



RETOUR D'EXPERIENCE Interoperability avec JMS 

Dans le precedent chapitre, Echanges B2B, nous avons vu les services web 
comme outils d'interoperabilite avec des systemes externes. On peut 
aussi utiliser les MOM (Middleware Oriented Messages) pour le faire. 
Imaginez une application externe developpee dans un langage different 
de Java (C++, PHP, .Net, etc.) et s'executant sur un systeme d'exploitation 
autre que le votre. II suffit qu'il y ait un MOM disponible (MQSeries par 
exemple) pour que cette application puisse envoyer et recevoir des mes- 
sages. Avec un systeme de bridge (pont), on peut alors relier les files 
d'attente de ces deux providers (MQSeries^GlassFish) et laisser les deux 
applications s'echanger des messages de maniere transparente. 

► http://www.activemq.org/site/jms-to-jms-bridge.html 

► http://edocs.bea.com/wls/docs81/ConsoleHelp/messaging_bridge.html 



Le cycle de vie d'un MDB 



GLASSFlSH MDB stockes dans un pool 



Bien que les specifications n'obligent pas les con- 
teneurs a avoir un pool de message-driven beans, 
la plupart des serveurs d'applications en utilise un 
pour augmenter les performances. C'est le cas de 
GlassFish qui les stocke dans un pool configurable. 
Sa taille est parametrable ainsi que sa taille mini- 
male et maximale. Cette configuration est faite via 
la console d'administration (menus Configura- 
tion>EJB Container>MDB Settings). 



Figure 10-4 

Cycle de vie d'un message-driven bean 



Le cycle de vie d'un message-driven bean est identique a celui d'un sta- 
teless bean. II n'a que deux etats : il existe ou il n'existe pas. Lorsqu'il 
existe, il est a l'ecoute d'une destination JMS, pret a traiter un message. 



Instantiation du compospnt 
: @P osteon struct 




L'etat inexistant signifie que le MDB n'a pas encore ete instancie et qu'il 
n'existe pas en memoire. Le passage a l'etat pret se fait lorsque le conte- 
neur intercepte l'arrivee d'un message et invoque la methode onMessage 
du MDB. 
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Les annotations de callback 

Grace aux annotations de callback, le conteneur d'EJB laisse la possibi- 
lity aux developpeurs d'effectuer des traitements lors du passage d'un 
etat a un autre. II existe deux annotations utilisables par les message- 
driven beans : 

• Ojavax. annotation . PostConstruct 

• Ojavax. annotation . PreDestroy 

Apres avoir instancie un message-driven bean, le conteneur execute les 
methodes annotees par ©PostConstruct. Dans le cas oil le conteneur 
supprime l'EJB de la memoire, les methodes annotees ©PreDestroy sont 
appelees. 



JavaMail 

Lorsque le bon de commande est cree, le systeme envoie un e-mail reca- 
pitulatif au client. JavaMail est l'API qui nous permet d'utiliser le cour- 
rier electronique. 

Le courrier electronique repose sur le concept de clients et de serveurs. Les 
clients de mail (tels que Outlook, Messenger, Eudora, etc.) s'appuient sur 
un serveur de messagerie pour obtenir et envoyer des e-mails. Ces echanges 
sont normalises par des protocoles particuliers (SMTP, POP3, etc.). 



Les principaux protocoles de messagerie 



• SMTP (Simple Mail Transport Protocol), protocole defini par la recom- 
mandation RFC 821, permet I'envoi d'e-mails vers un serveur. 

• POP3 (Post Office Protocol), defini par la recommandation RFC 1939, 
permet la reception d'e-mails. Protocole tres populaire sur Internet, il 
definit une boite aux lettres unique pour chaque utilisateur. 

• IMAP (Internet Message Access Protocol), defini par la recommandation 
RFC 2060, permet la reception d'e-mails. Ce protocole est plus com- 
plexe car il apporte des fonctionnalites supplementaires : plusieurs 
repertoires par utilisateur, partage de repertoires entre plusieurs utili- 
sateurs, maintien des messages sur le serveur, etc. 

• NNTP (Network News Transport Protocol) est utilise par les forums de dis- 
cussion (news). 

Les RFC (Request for Comments) se trouvent a I'adresse suivante : 
► http://www.ietf.org/rfc.html 



Approfondir JavaMail 



► http://java.sun.com/products/javamail/ 

► http://java.sun.com/developer/ 
onlineTraining/JavaMail/contents.html 

► http://www.javaworld.com/jw-10-2001/ 
jw-1026-javamail.html 



L'API JavaMail permet de s'abstraire de tout systeme de mail et d'uti- 
liser la plupart des protocoles de communication de maniere transpa- 
rente. Ce n'est pas un serveur d'e-mails, mais un outil pour interagir avec 



JavaMail Un serveur SMTP 

Pour pouvoir envoyer un e-mail, il vous faut con- 
naftre les parametres de connexion d'un serveur 
de messagerie. Ce livre utilise le serveur SMTP du 
fournisseur d'acces Free, mais vous pouvez utiliser 
le serveur de votre choix, il suffit de changer les 
parametres. 



JavaMail Le type MIME 

Le type MIME (Multipurpose Internet Mail 
Extensions) est un standard permettant 
d'etendre les possibility du courrier electronique, 
comme la possibility d'inserer des documents 
(images, sons, texte, etc.) dans un courrier. 



JavaMail Les destinataires 

Lorsqu'on envoie un e-mail, I'adresse du destina- 
taire peut etre typee : 

• Reci pi entType . TO : destinataire direct ; 

• Reci pi entType . CC : copie conforme ; 

• Reci pi entType . BCC : copie cachee. 



le serveur de messagerie. Les applications developpees avec JavaMail 
sont ainsi comparables aux differentes messageries rencontrees, telles 
que Outlook, Lotus, Eudora, etc. Cette API propose done des 
methodes pour lire ou envoyer des e-mails, rechercher un message, etc. 
Les classes et interfaces de cette API sont regroupees dans le paquetage 
j avax . mai 1 . 

Dans notre application, nous utiliserons le cas simple d'un envoi d'e-mail 
par SMTP. Pour cet exemple, nous n'utiliserons pas toute la panoplie des 
classes et interfaces de 1API, mais juste les principales, e'est-a-dire : 
Session, Message, Transport et InternetAddress. 

La classe Session 

A la maniere de JMS, JavaMail possede une classe javax.mail .Session 
qui etablit la connexion avec le serveur de messagerie. C'est elle qui encap- 
sule les donnees liees a la connexion (options de configuration, login, mot 
de passe, nom du serveur) et a partir de laquelle les actions sont realisees. 

Creation d'une session JavaMail 

Properties properties = new PropertiesO ; 
properti es . put ("mai 1 . smtp. host" , "smtp . free . f r") ; 
properti es . put ("mai 1 . smtp . auth" , "true") ; 

Session session = Session. getInstance(properti es , null); 0 

Pour creer une session, on utilise la methode getlnstance Q a laquelle 
on passe les parametres d'initialisation. 

La classe Message 

La classe javax.mail .Message est une classe abstraite qui encapsule le 
contenu du courrier electronique. Un message est compose d'un en-tete 
qui contient I'adresse de l'auteur et du destinataire, le sujet, etc. et d'un 
corps qui contient les donnees a envoyer. JavaMail fournit en standard 
une classe fille nommee javax.mail .internet. MimeMessage pour les 
messages possedant un type MIME. 

La classe Message possede de nombreuses methodes pour initialiser les 
donnees du message. Nous utiliserons les principales qui permettent de 
positionner I'adresse de l'emetteur Q, du destinataire 0, le sujet 0 et le 
corps du message © ainsi que la date d'envoi 0. 
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Creation d'un message 



Message msg = new MimeMessage(session) ; 

msg . setFrom(new InternetAddress("adresse@emetteur . com")) I O 
msg . setReci pi ents (Message . RecipientType.TO, 0 

new InternetAddress("adresse@desti natai re.com")) ; 
msg . setSubject("Confi rmati on de commande"); 0 
msg.setText("La commande n°1002 a ete creee"); 0 
msg.setSentDate(new Date()); 0 



La classe Internet Address 

La classe javax. mail .internet. InternetAddress est necessaire pour 
chaque emetteur et destinataire d'e-mail. Elle herite de la classe 
javax. mail .Address et represente une adresse e-mail au format 
contact@serveurmai1.com. Pour creer une adresse e-mail, il suffit de 
passer une chaine de caracteres au constructeur. 

Utilisation des adresses 

Message msg = new MimeMessage(session) ; 

msg . set From (new InternetAddress ("ad resse@emetteur.com")) ; 
msg . setReci pi ents (Message . Reci pi entType .TO, 

new InternetAddress("adresse@destinatai re.com")) ; 



La classe Transport 

La classe javax. mail .Transport se charge d'envoyer le message avec le 
protocole adequat. Dans notre cas, pour SMTP, il faut obtenir un objet 
Transport dedie a ce protocole en utilisant la methode 
getTransport("smtp") d'un objet Session 0. II faut ensuite etablir la 
connexion en utilisant la methode connect () 0 en passant le nom du 
serveur de messagerie, le nom de i'utilisateur et son mot de passe. Pour 
envoyer le message que Ton aura cree anterieurement, il faut utiliser la 
methode sendMessage() 0 en lui passant la liste des destinataires 
getAll Reci pi ents (). Enfin, il faut fermer la connexion a l'aide de la 
methode close () 0. 

Envoi d'un e-mail 

Transport transport = session. getTransport("smtp") ; 0 
transport. connect("smtp.f ree.fr" , "user", "password");© 
transport. sendMessage(msg, msg.getAHRecipientsO) ; 0 
transport. closeQ ; 0 



Architecture Attention au pare-feu 

Si vous avez un firewall (pare-feu) sur votre 
machine, verifiez bien qu'il autorise le protocole 
SMTP sur le port 25. Sinon, les e-mails seront blo- 
ques et ne pourront pas etre envoyes. 
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Les traitements asynchrones de YAPS 
Pet Store 

L'application YAPS Pet Store comprend des traitements qui peuvent 
etre longs : elle doit done avoir recours au mode asynchrone pour ne pas 
penaliser ses temps de reponse. Lorsqu'un client achete des animaux et 
qu'il confirme cet achat en ligne, un e-mail recapitulant ses achats doit 
lui etre envoye, et le bon de commande doit etre imprime pour etre 
archive par la societe. Ces deux traitements peuvent etre extremement 
longs si l'imprimante est eteinte ou le serveur de messagerie hors service, 
par exemple. lis seront done traites de maniere asynchrone par des mes- 
sage-driven beans. 

Pour des raisons administratives, les employes doivent etre alertes des 
commandes contenant des reptiles. Leur application Swing peut etre 
arretee, ou les employes ne pas etre connectes. lis doivent done pouvoir 
recevoir ces alertes une fois a leur poste de travail. Nous utiliserons un 
listener JMS sur l'application Swing qui selectionnera les messages con- 
tenant une propriete particuliere l'informant que la commande contient 
des reptiles. 

Tous ces composants seront a l'ecoute du meme Topic. Lors de la crea- 
tion d'un bon de commande, le stateless session bean enverra un message 
contenant le bon de commande dans le Topic jms/topi c/order. A l'autre 
bout, deux MDB s'occuperont d'imprimer le bon de commande et 
d'envoyer un e-mail, tandis que le client Swing affichera une alerte pour 
les commandes comportant des reptiles (figure 10-5). 



« Message Driven Bean» 
E mails enderB ean 



+onMessage(message : Message) : vi 



< Session Bean» 
Ordeftiean 



-publishOrder(order : Order) : void 




Figure 10-5 

Le stateless bean envoie 
un message dans le Topic. 



« Message Driven Bean» 
OiderPrinteffiean 
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L'envoi du message 

L'envoi du message JMS se fait apres la creation du bon de commande. 
C'est done l'EJB stateless OrderBean qui utilise l'API JMS pour envoyer 
le message contenant le bon de commande. 



L'EJB OrderBean envoie un message 

public class OrderBean implements OrderRemote , OrderLocal { 

@Resource(mappedName = "jms/petstoreConnectionFactory") 
private ConnectionFactory connectionFactory ; 
@Resource(mappedName = " jms/topi c/order") 
private Topic destinationOrder; 

@PostConstruct 

public void openConnection() { 
try { 

connection = connectionFactory .createConnectionO ; 
} catch (JMSException e) { 
throw new EJBException(e) ; 

} 



@PreDestroy 

public void closeConnectionO { 
if (connection != null) { 
try { 

connection. c"lose() ; 
} catch (DMSException e) { 
throw new EJBException(e) ; 

} 

} 

} 

public Order createOrder (Customer customer, 

Address deliveryAddress, CreditCard creditCard, 
Li st<CartItem> cartltems) { 

Order order = new Order(customer , 

em.merge(deliveryAddress) , creditCard) ; 
Li st<OrderLi ne> orderLines = new ArrayLi st<OrderLi ne>() ; 

for (Cartltem cartltem : cartltems) { 

order Li nes .add (new 0 rder Li ne (cartltem . getQuantityO , 

cartltem. getltem())) ; 

} 

order . setOrderLi nes (order Li nes) ; 
em. persi st(order) ; 

pub! ishOrder (order) ; 
return order; 



Architecture Le couplage lache 

La logique metier pour creer un bon de commande a 
considerablement change entre sa premiere imple- 
mentation et maintenant. La couche de stateless 
bean a ete regulierement mise a jour, mais pas les 
clients. C'est un des avantages d'un couplage lache 
entre les couches : une partie du systeme peut etre 
mise a jour sans avoir d'effet sur une autre. 



Injection de la fabrique de connexions et du 
Topic declares dans GlassFish. 



Grace aux annotations de callback, on cree une 
connexion au provider JMS, a I'instanciation du 
stateless bean. 



Lorsque le stateless bean est supprime de la 
memoire, on libere les ressources JMS en clotu- 
rant la connexion. 



A I'aide de I'entity manager, on persiste I'entity 
bon de commande ainsi que ses lignes de com- 
mande. 



On envoie un message dans le Topic. 
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On cree une session JMS avec un acquittement 
automatique des messages. 



On cree un MessageProducer qui, dans 
notre cas, sera un Topi cPubl i she r. 



On cree un message de type objet. 



Dans les proprietes du message, on rajoute les 
categories que Ton trouve dans le bon de com- 
mande (chiens, chats, reptiles, etc.). 



On affecte au corps du message I'entity bon de 
commande. 



Le message est envoye dans le Topic. 



On referme la session et la connexion. 



private void pub! ishOrder(Order order) { 
Session session = null; 
try { 

session = connection. createSession(true, 

Session.AUTO_ACKNOWL.EDGE) ; 

MessageProducer producer = 

session . createProducer(desti nationOrder) ; 

ObjectMessage objectMessage = 

session . createObjectMessage() ; 

Set<Category> categories = order. getDistinctCategories() ; 
for (Category c : categories) { 

objectMessage. setBool eanProperty(c . getName() , true) ; 

} 

objectMessage. setObject (order) ; 

producer. send(objectMessage) ; 

} catch (JMSException e) { 
throw new EJBException(e) ; 

} finally { 

session. close() ; 

// gestion des exceptions 

} 



Les message-driven beans 

Une fois le message JMS envoye, les message-driven beans, qui sont a 
l'ecoute du Topic, peuvent traiter le contenu du message. 



Figure 10-6 

Diagramme de classes 
des message-driven beans 




Envoi d'e-mails 

Le MDB Email SenderBean a pour role d'envoyer un e-mail a chaque 
reception de messages. Cet e-mail, a destination du client, recapitule le 
contenu de sa commande. Voici un exemple : 

Subject : [YAPS] Confirmation: Order #1002 Q 

Dear Paul Smith, 0 
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your order #1002 has been successfully placed. 
Your shopping cart content is: 
Goldfish female * 2 © 
Iguana male *5 

Looking forward to serve you again, 
The YAPS team. 

Pour constituer cet e-mail, le MDB a besoin de connaitre le numero du 
bon de commande Q, le nom du client © ainsi que son adresse e-mail © 
et le contenu de son panier electronique ©. 

Extrait du MDB EmailSenderBean 

@MessageDriven(mappedName = " jms/topi c/order") 

public class EmailSenderBean implements MessageLi stener { 

private static final String SMTP_H0ST = "smtp.free.fr"; 
private static final String USER = "yaps . petstore" ; 
private static final String PASSWORD = "yapspwd"; 

public void onMessage(Message message) { 
try { 

if (message instanceof ObjectMessage) { 

ObjectMessage msg = (ObjectMessage) message; 
Order order = (Order) msg . getObject() ; 

sendEMail (order) ; 



} 

} catch (JMSException e) { 

} catch (MessagingException e) { 

// gestion des exceptions 

} 



MDB a l'ecoute du Topic jms/topi c/order. 



Proprietes pour acceder au serveur de message- 
rie. 



La methode onMessage est le point d'entree 
du message-driven bean. Celui-ci recoit un mes- 
sage du Topic et en recupere le contenu qui se 
trouve etre un entity Order. 



Appelle une methode privee pour envoyer le 
message. 



private void sendEMail (Order order) throws Messagi ngException{ 



Properties properties = new Properties() ; 

properti es . put ("mai 1 . smtp . host" , SMTP_H0ST) ; 

properti es . put ("mai 1 . smtp . auth" , "true") ; 

Session session = Session. getInstance(properties, null); 

Message msg = new MimeMessage(session) ; 

msg. set From (new InternetAddress ("no- reply@petstore.org")) ; 
String email = order. getCustomer() .getEmail () ; © 
msg . setReci pi ents (Message . Reci pi entType . TO , 

InternetAddress. parse(email , false)) ; 
msg.setSentDate(new Date()); 

msg.setSubject("[YAPS] Confirmation: Order #" + © 

order. getld()) ; 



< On cree une session JavaMail. 



Le message JavaMail est envoye a I'adresse 
e-mail du client. 



i Lesujetdel'e-mail. 
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Une methode privee cree le corps du message. 



L'e-mail est envoye au serveur de messagerie par 
protocole SMTP, 



} 



msg.setText(formatBody(order)) ; 

Transport transport = session. getTransport("smtp") ; 
transport. connect (SMTP_H0ST, USER, PASSWORD); 
transport . sendMessage(msg , msg . getAl 1 Reci pi entsO) ; 
// gestion des exceptions 
transport. closeQ ; 



MDB a I'ecoute du Topic jms/topi c/order. 



Le logger fait office d'impression. 



La methode onMessage recoit un message du 
Topic et en recupere le contenu qui est un bon de 
commande. 



Appelle une methode privee pour imprimer le 
bon de commande. 



L'impression du bon de commande utilise I'API 
de logging Java pour afficher les informations. 



Impression du bon de commande 

Un autre MDB est a I'ecoute du Topic : 1'OrderPrinterBean. A chaque 
message recu, ce message-driven bean imprime un bon de commande. 
L'impression en Java est fastidieuse et ce nest pas le theme du livre (voir 
encadre ci-apres). Dans l'exemple de code suivant, l'API de logging 
(journalisation) est utilisee pour afficher les donnees du bon de com- 
mande. Vous pourrez consulter les logs du serveur GlassFish pour en 
voir le descriptif. 

Extrait du MDB OrderPrinterBean 

@MessageDriven(mappedName = "jms/topi c/order") 

public class OrderPrinterBean implements MessageLi stener { 

private Logger logger = 

Logger .getLogger ("com. yaps . petstore.mdb") ; 

public void onMessage(Message message) { 
try { 

if (message instanceof ObjectMessage) { 

ObjectMessage msg = (ObjectMessage) message; 
Order order = (Order) msg.getObject() ; 

printOrder(order) ; 

} 

} catch (JMSException e) { 
throw new ElBException(e) ; 

} 

} 

private void printOrder (Order order) { 

logger. info("0rder # " + order . getld() + " on the " + 

date Format . format (order . getOrderDate())) ; 
logger. info(order.getCustomer() .getFi rstname() + 

order. getCustomer() .getLastname() + " bought ") ; 
for (OrderLine line : order. getOrderLinesO) { 

logger. info("\t" + 1 i ne . getltem() .getName() + "*" + 

1 i ne . getQuanti ty() + "=" + 1 i ne . getSubTotal ()) ; 

} 

logger. info("Total=" + order. getTotal ()) ; 

} 
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Retour d'experience L'impression en Java 



L'impression en Java natif est un exercice complexe et fastidieux. II suffit, pours'en rendre 
compte, de consulter les classes et interfaces des sous-paquetages javax . pri nt. Pour 
pallier ce probleme, une multitude d'outils (Open Source ou non) vient aider le deve- 
loppeur dans cette lourde tache. Le probleme de ces outils est qu'ils ont tous leur propre 
maniere de faire. II est alors impossible de les interchanger si besoin. 
Une autre possibility beaucoup plus portable, est d'utiliser XML et les transformations 
XSL (extensible Stylesheet Language). Nous avons vu dans le precedent chapitre qu'en 
utilisant les annotations JAXB, il etait facile de transformer une grappe d'objets en flux 
XML. C'est ceque nous aurions pu faire avec I'entity Order. En plus des annotations JPA 
pour le rendre persistant, nous aurions pu rajouter des annotations JAXB pour obtenir une 
representation XML du bon de commande. Ensuite, en effectuant une transformation XSL, 
on aurait pu transformer ce flux en page web ou en document PDF. Une fois le fichier PDF 
obtenu, on peut alors utiliser I'API javax. pri nt pour I'envoyer vers une imprimante. 
L'utilitaire Open Source d'Apache FOP (Formatting Objects Processor) est souvent uti- 
lise dans les projets pour simplifier les transformations XSL. II permet tres facilement de 
produire un document PDF, SVG, TXT, etc. a partir d'un document XML. 
FOP: 

► http://xmlgraphics.apache.org/fop/ 

► http://www.onjava.eom/pub/a/onjava/2002/10/16/fop.html 
D'autres outils d'impression : 

ReportCat 

► http://www.netcat.li/java-report-printing-library/ 
Java Print Dialog Framework 

► http://www.softframeworks.com 
RReport 

► http://www.java4less.com/printjava_e.htm 
Crystal Reports 




Listener JMS de Implication Swing 

L'interface homme-machine doit, elle aussi, etre a l'ecoute du Topic. En fait, 
elle affiche en temps reel uniquement les informations des bons de com- 
mande contenant des reptiles, et ceci grace au message selector de JMS. 

Un nouveau sous-menu Watch orders affiche un composant JTable qui se 
rafraichit automatiquement a l'arrivee d'un message. Pour ne pas bloquer 
l'affichage, cette fenetre s' execute dans un Thread a part. 

Comme nous l'avons deja explique, pour des raisons pedagogiques, 
l'application graphique n'utilise pas le conteneur client (ACC). Pour 
recuperer la reference vers la fabrique de connexions JMS et le Topic, 
elle doit done utiliser JNDI pour les localiser. Pour masquer ces appels a 
l'API JNDI, nous pouvons enrichir le Service Locator que nous avons 
vu au chapitre 6, Execution de 1' application. 



Design pattern ServiceLocator. 



Systeme de cache du service locator. 



Retourne une fabrique de connexions JMS. 



Retourne une destination JMS. 



Methode privee permettant de retrouver un 
objet dans le cache ou dans JNDI. 



On declare la fabrique de connexions et le Topic. ► 



Utilisation du service locator pour obtenir la 
fabrique de connexions JMS et le Topic. 



On se connecte au provider de messages. 



On cree une session. 



Extrait du ServiceLocator avec les nouvelles methodes 

public class ServiceLocator { 

private Context initalContext; 
private Map<String, Object> cache; 

public ConnectionFactory getConnectionFactory 

(String connFactoryName) throws ServiceLocatorException { 
ConnectionFactory factory = (ConnectionFactory) 

getRemoteObject (connFactoryName) ; 

return factory; 

} 

public Destination getDestination(Stri ng desti nationName) { 
Destination destination = (Destination) 

getRemoteObject(desti nationName) ; 

return destination; 

} 

private synchronized Object getRemoteObject (St ri ng jndiName) 

throws ServiceLocatorException { 
Object remoteObject = cache. get(jndiName) ; 
if (remoteObject == null) { 
try { 

remoteObject = initalContext. lookup(jndiName) ; 
cache. put (jndiName, remoteObject) ; 
} catch (Exception e) { 

throw new ServiceLocatorException(e) ; 

} 

} 

return remoteObject; 

} 

} 

L'application Swing n'a plus qua utiliser le ServiceLocator pour obtenir 
la fabrique de connexions et la destination sur laquelle ecouter. 

Reception d'un message 

public class YapsMsgListener implements MessageLi stener { 

private ConnectionFactory ConnectionFactory; 
private Topic destinationOrder; 

private void recei veOrder(Order order) { 

// Pour simplifier la lecture du code, la reception 

// asynchrone a l'aide d'un thread n'est pas implementee 

ConnectionFactory = ServiceLocator .getlnstance() . 

getConnecti on Facto ry(" jms/petstoreConnecti on Factory") ; 
destinationOrder = ServiceLocator. getlnstance() . 

getDesti nation("jms/topic/order") ; 

Connection connection = 

ConnectionFactory . createConnecti on () ; 

Session session = connection. createSession(true, 

Session.AUTO_ACKNOWLEDGE) ; 
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MessageConsumer consumer = session. createConsumer 

(desti nationOrder , "Repti 1 es=true") ; 

consumer . setMessageLi stener(thi s) ; 

connecti on. start() ; 



} 



public void onMessage(Message message) { 
if (message instanceof ObjectMessage) { 

ObjectMessage objMsg = (ObjectMessage) message; 
tableModel . add(objMsg . getObjectO) ; 

} 

} 

} 

Le resultat graphique est le suivant (figure 10-7). Les commandes con- 
tenant des reptiles s'affichent au fur et a mesure de leur arrivee dans une 
liste. En selectionnant une commande et en cliquant sur le bouton View 
on peut en connaitre le detail. 



On cree un MessageProducer qui filtre les mes- 
sages sur la propriete Repti 1es=true. 



On associe un listener a la classe courante. 



On demarre la connexion. 



Les messages arrivent par la methode 
onMessage et sont affiches dans une JTable. 



File Customer Catalog 



□ order- 157 



G watcn for new orders containing reptiles 



ID 


Date 


Customer Name 


Nurnljei of items 


Total 


161 


02/01(2007 


JuliO StOVO 


2 


HUM 


1 5-1 


ojintijofi? 


Jobs Steve. 


2 


32 0 


1 



Create |P Ww ^Update 



Order -157 (Read only) 



identifier 
Order dale 
Customer 
First Maine 
Last Maine 
Date nt hirtl 
Address 
Street 1 
Street 2 
My 
Slat 
Opcode 
Country 



157 

02(0112007 



Bill 
Gates 
m ItifllVflHIifi 

27WestOide 
Story 

Alhahama 
TX 



ID 


Item 


i, ua-Uit,' 


bUD-IOtal 


100 


MaleAdull 


1 


120 0 


159 


Spotless Female Puppy 


1 


22.0 


150 


Male Adult 


5 


100.0 





Delivery Address 



Street 1 27 West Side 



lotal jj: : 



V stray 



Cily 
State 



Alliabarna 
TX 



8401 
USA 



Zipcodc 8401 



Country USA 



1234 
Type visa 
Expiry date 01(03 



Find 



Create Update 



Figure 10-7 Application Swing recevant les messages 
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f£ com 
h- ©yaps 

fe- §/ petstore 
- S3 client 



k- Si email 

L- '£) EmailSenderBean 
4- S? print 

1— OrderPrinterBean 
- S3 stateful 
h ElD stateless 
util 



Figure 10-8 Message-driven beans 



Paquetages des MDB 

Les classes des message-driven beans (impression et envoi de d'e-mail) 
sont placees dans le sous-paquetage de com.yaps.petstore.mdb. Pour le 
listener cote client, les classes se trouvent essentiellement dans le paque- 
tage com. yaps. petstore. client. util . jms. 



Architecture 

L'architecture globale contient maintenant les message-driven beans. lis 
sont representes comme des composants qui exposent une interface 
(MessageListener) ecoutant sur une destination JMS. Comme il n'y a 
pas d'appel direct entre le stateless qui envoie les messages (OrderBean), 
et les MDB qui les recoivent, le diagramme suivant ne fait pas apparaitre 
de liaison (ligne en pointille) entre ces composants (figure 10-9). Notez 
que le client Swing est aussi a l'ecoute d'une destination JMS. 




«component>> c5jj 
E mails ewlerBean 



-o 



«component>> q 
OrderPrinterBean ' 



rn 


8- 


petex 


«com ponent>>^| 




Delivery 











[HTTP 



<com ponent>>^j 
Validation 



Figure 10-9 Architecture avec les MDB 
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Executer l'application 



Pour executer l'application, il faut utiliser les memes taches Ant yaps- 
clean, yaps-build et yaps-deploy qui compileront, packageront les 
classes et deploieront les fichiers archives. Les message-driven beans 
sont deployes dans un fichier .jar- a part : mdb. jar qui est inclus dans le 
petstore.ear. 

Vous pouvez maintenant utiliser l'application web pour acheter des ani- 
maux domestiques. Ceci aura pour consequence d'envoyer un e-mail en 
utilisant votre serveur de messagerie et d'afficher les informations du 
bon de commande dans les logs GlassFish. Si vous achetez un reptile, 
vous verrez l'interface Swing recevoir un evenement. 



51 petstore.ear 

- (3 utility jar 

- 9 ws-inlerface |ar 
SI entity jar 

L Cg persistence.xml 
state less.jar 
<S& slaleful iar 
% mdb.jar 
CJ pelstore war 

E9 WEB-INF 

tS (aces-config.xml 
i^l web.xml 



Figure 10-10 Contenu du fichier petstore.ear 



En resume 

Ce chapitre complete le developpement de l'application YAPS 
Pet Store. Lorsque les clients valident leurs achats sur le site, le systeme 
doit envoyer un e-mail de confirmation, imprimer un bon de commande 
et alerter les employes des achats contenant des reptiles. Tous ces traite- 
ments se font de maniere asynchrone en utilisant JMS et les message- 
driven beans. 
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Specifications Java EE 5 



A 



Les specifications Java EE s'accumulent ou se subdivisent. Certaines 
disparaissent tandis que d'autres naissent. C'est pourquoi chacune 
d'entre elles possede un numero de version et un numero de JSR {Java 
Specification Request). Pour s'y retrouver plus aisement, les tableaux ci- 
dessous dressent une liste exhaustive des specifications qui composent a 
ce jour Java EE 5. 



Tableau A-1 Specifications Java Enterprise Edition 5 




Tableau A-2 Specifications Web Services 



Specification 


Version 




URL 


JAX-RPC (Java APIs for XML-based RPC) 


1.1 


101 


http://jcp.org/en/jsr/detail?id=101 


JAX-WS (Java API for XML-based Web Services) 


2.0 


224 


http://jcp.org/en/jsr/detail?id=224 


JAXB (Java Architecture for XML Binding) 


2.0 


222 


http://jcp.org/en/jsr/detail?id=222 


SAAJ (Soap with Attachments API for Java) 


1.0 


67 


http://jcp.org/en/jsr/detail?id=67 


StAX (Streaming API for XML) 


1.0 


173 


http://jcp.org/en/jsr/detail?id=173 


Web Services 


1.2 


109 


http://jcp.org/en/jsr/detail?id=109 


Web Services Metadata 


2.0 


181 


http://jcp.org/en/jsr/detail?id=181 



Tableau A-3 Specifications web 











JSF (JavaServer Faces) 


1.2 


252 


http://jcp.org/en/jsr/detail?id=252 


JSP (JavaServer Pages) 


2.1 


245 


http://www.jcp.org/en/jsr/detail?id=245 


JSTL (JavaServer Pages Standard Tag Library) 


1.2 


52 


http://jcp.org/en/jsr/detail?id=52 



Tableau A-3 Specifications web 





Version 


JSR 


URL 


Servlet 


2.5 


154 


http://jcp.org/en/jsr/detail?id=154 


Tableau A-4 Specifications Enterprise 




Common Annotations 


1.0 


250 


http://jcp.org/en/jsr/detail7ick250 


EJB (Enterprise JavaBeans) 


3.0 


220 


http://jcp.org/en/jsr/detail?id=220 


JAF (JavaBeans Activation Framework) 


1.1 


925 


http://jcp.org/en/jsr/detail?id=925 


JavaMail 


1.4 


919 


http://jcp.org/en/jsr/detail?id=919 


JCA (J2EE Connector Architecture) 


1.5 


112 


http://jcp.org/en/jsr/detail?id=1 1 2 


JMS (Java Message Service) 


1.1 


914 


http://jcp.org/en/jsr/detail?id=914 


JPA (Java Persistence API) 


1.0 


220 


http://jcp.org/en/jsr/detail?id=220 


JTA (Java Transaction API) 


1.1 


907 


http://jcp.org/en/jsr/detail?id=907 


Tableau A-5 Specifications Management et securite 










JACC (Java Authorization Contract for Containers) 


1.1 


115 


http://jcp.org/en/jsr/detail?id=1 1 5 


Java EE Application Deployment 


1.2 


88 


http://jcp.org/en/jsr/detail?id=88 


Java EE Management 


1.1 


77 


http://jcp.org/en/jsr/detail?id=77 
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Taches Ant 



B 



Ce livre utilise des taches Ant pour compiler, packager, deployer les 
applications (fichier build.xml) ainsi que pour administrer le serveur 
GlassFish (fichier admin. xml). Vous retrouverez ces fichiers sur le site 
Telecharger Ant 1 7 www.antoniogoncalves.org. Pour pouvoir executer ces taches, vous devez 

avoir installe Ant au prealable et ajoute le repertoire %ANT_HOME%/bi n 



► http://ant.apache.org/ dans votre varia bl e PATH. 



Build.xml 

Dans ce fichier, vous trouverez toutes les taches utilisees pour les appli- 
cations YAPS Pet Store, BarkBank et PetEx. Pour les executer, il suffit 
de taper la ligne de commande suivante : 

| ant <le nom de la tache> 

Vous trouverez dans le fichier ci-dessous la liste des taches que vous 
pouvez executer. 



Variables globales de I'application. 



Variables propres de I'application YAPS 
Pet Store. 



<?xml version^" 
<project name=" 

<property name= 
<property name= 
<property name= 
<property name= 
<property name= 

<property name= 
<property name 
<property name 
<property name 
<property name 
val ue 



1.0"?> 
Petstore' 



def aul t="core"> 



"appl i cati on . name" val ue="petstore"/> 
"home.dir" value="."/> 

"barkbank . home" val ue="${home . di r}/barkbank"/> 
"petex. home" val ue="${home . di r}/petex"/> 
"yaps . home" val ue="${home . di r}/yaps"/> 

"yaps . bui 1 d . di r" val ue="${yaps . home}/bui 1 d"/> 
"yaps . conf i g . di r" val ue="${yaps . home}/ conf i g"/> 
"yaps . src . di r" val ue="${yaps . home}/src"/> 
"yaps .web . di r" val ue="${yaps . home}/ resources"/> 
"yaps.web-inf .dir" 

${yaps . home}/web-i nf "/> 



Variables propres de I'application BarkBank. 



Variables propres de I'application PetEx. 



Fichiers pour le deploiement de I'application 
YAPS Pet Store. 



Fichier pour le deploiement de I'application 
BarkBank. 



Fichier pour le deploiement de I'application 
PetEx. 



<property name="yaps . generated . src . di r" 

val ue="${yaps . home}/gene rated "/> 
<property name="yaps . cl asses . di r" 

val ue="${yaps . home}/cl asses/production"/> 

<property name="barkbank. bun Id . di r" 

val ue="${barkbank. home}/bui ld"/> 
<property name="barkbank. src . di r" 

val ue="${barkbank. home}/src"/> 
<property name="barkbank.web.di r" 

val ue="${barkbank. home}/ resources "/> 
<property name="barkbank.web-inf .di r" 

val ue="${barkbank. home}/web-i nf "/> 
<property name="barkbank. generated. src. di r" 

val ue="${barkbank. home}/gene rated "/> 
<property name="barkbank. classes .di r" 

value="${barkbank. home}/classes/production"/> 

<property name="petex . bui 1 d . di r" val ue="${petex . home}/bui ld"/> 
<property name="petex.src.di r" value="${petex.home}/src"/> 
<property name="petex .web . di r" 

value="${petex. home}/resources"/> 
<property name="petex.web-inf .di r" 

val ue="${petex . home}/web-i nf "/> 
<property name=" petex. gene rated. src. di r" 

val ue="${petex. home}/generated"/> 
<property name="petex. classes. di r" 

value="${petex. home}/classes/production"/> 

<property name="yaps . cl i ent .jar" 

val ue="${yaps . bui 1 d . di r}/${appl i cati on . name} . jar"/> 
<property name="yaps . uti 1 i ty . jar" 

val ue="${yaps . bui 1 d . di r}/l i b/ uti 1 i ty . jar"/> 
<property name="yaps .ws . jar" 

val ue="${yaps . bui 1 d . di r}/l i b/ws-i nterf ace . j ar"/> 
<prope rty name="yaps . enti ty . jar" 

val ue="${yaps . bui 1 d . di r}/l i b/enti ty . jar"/> 
<property name="yaps.mdb. jar" 

val ue="${yaps . bui 1 d . di r}/mdb . jar"/> 
<p rope rty name="yaps . stateless .jar" 

val ue="${yaps . bui 1 d . di r}/statel ess . jar"/> 
<property name="yaps . statef ul .jar" 

value="${yaps.build.di r}/stateful . jar"/> 
<property name="yaps .war" 

val ue="${yaps . bui 1 d . di r}/${appl i cati on . name} .war"/> 
<property name="yaps . ear" 

val ue="${yaps . bui 1 d . di r}/${appl i cati on . name} . ear"/> 

<property name="barkbank.war" 

value="${barkbank.build.di r}/barkbank.war"/> 

<property name="petex.war" 

val ue="$ {petex. build .di r}/petex .war"/> 
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<property envi ronment="env"/> 
<property name="gl assfi sh . home" 

value="${env.GLASSFISH_HOME}"/> 
<property name="gl assfi sh . 1 i b" val ue="${gl assfi sh . home}/l i b"/> 
<property name="derby . home" val ue="${gl assf i sh . home}/javadb"/> 
<property name="derby.lib" value="${derby.home}/lib"/> 
<property name="asadmi n" 

val ue="${gl assfi sh . home}/bi n/asadmi n . bat"/> 
<property name="wsgen" 

val ue="${gl assfi sh . home}/bi n/wsgen . bat"/> 
<property name="wsimport" 

val ue="${gl assf i sh . home}/bi n/wsi mport . bat"/> 
<property name="echo" val ue="fal se"/> 
<property name="veri f i er" 

val ue="${gl assf i sh . home}/bi n/veri f i er . bat"/> 
<property name="veri f i er . di r" val ue="${home . di r}/veri f i er"/> 



■5 

Variables d'environnement et utilitaires d'admi- , 
nistration et de generation de GlassFish. 00 



<property name="server . user . name" val ue="admi n"/> < Proprietes du serveur GlassFish. 

<property name="server.passwordfile" val ue="passwordfi 1 e"/> 

<property name="server. host" value="localhost"/> 

<property name="server . port" val ue="8080"/> 

<property name="server . admi n . port" val ue="8282"/> 



<property name="db . host" value="localhost"/> < Proprietes de la base de donnees Derby. 

<property name="db . port" val ue="1527"/> 

<property name="db . si d" value="${application.name}DB"/> 

<property name="db . user" val ue="dbuser"/> 

<property name="db . password" val ue="dbpwd"/> 

<property name="db. driver" 

val ue="org . apache . derby . jdbc . CI i entDri ver"/> 
<property name="db . url " 

valuer" jdbc:derby://${db. host} :${db.port}/${db.sid}"/> 



<path id="dasspath"> 

<pathel ement 1 ocati on="${gl assf i sh .lib}/ 

appserv-deployment-cl ient . jar"/> 
<pathel ement 1 ocati on="${gl assf i sh . 1 i b}/appserv- rt . jar"/> 
<pathel ement 1 ocati on="${gl assfi sh .lib}/ 

webservices-rt. jar"/> 
<pathel ement 1 ocati on="${gl assfi sh . 1 i b}/appserv-admi n . jar"/> 
<pathel ement 1 ocati on="${gl assfi sh . 1 i b}/javaee . jar"/> 
<pathel ement 1 ocati on="${gl assfi sh . 1 i b}/ 

toplink-essentials-agent.jar"/> 
<pathel ement 1 ocati on="${gl assf i sh .lib}/ 

toplink-essentials. jar"/> 
<pathel ement 1 ocati on="${gl assf i sh . 1 i b}/i nstal 1 / 

appl i cations/ jmsra/imqjmsra. jar"/> 
<pathel ement 1 ocati on="$ {derby . 1 i b}/derbycl i ent . jar"/> 
</path> 



Classes et JAR utilises pour compiler et executer 
I'application. 



<path id="yaps-classpath"> < I Classes de I'application YAPS Pet Store. 

<pathel ement 1 ocati on="${yaps . cl asses . di r} "/> 
</path> 
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Classes de I'application BarkBank. 



Classes de I'application PetEx. 



Suppression des repertoires de travail des appli- 
cations YAPS Pet Store, Barkbank et PetEx. 



Suppression des repertoires de travail de I'appli- 
cation YAPS Pet Store. 



Suppression des repertoires de travail de I'appli- 
cation Barkbank. 



Suppression des repertoires de travail de I'appli- 
cation PetEx. 



Creation des repertoires de travail des applica- 
tions YAPS Pet Store, Barkbank et PetEx. 



Creation des repertoires de travail de I'applica- 
tion YAPS Pet Store. 



Creation des repertoires de travail de I'applica- 
tion BarkBank. 



<path i d="barkbank-cl asspath"> 

<pathe1ement 1 ocation="${barkbank. classes . di r}"/> 
</path> 

<path id="petex-dasspath"> 

<pathe1ement location="${petex. classes. di r}"/> 
</path> 

<target name="cl ean"> 

ontcall target="yaps-cl ean"/> 

ontcal 1 target="barkbank-cl ean"/> 

ontcall target="petex-dean"/> 
</target> 

<target name="yaps-clean"> 

<echo message="Cleans the Yaps envi ronment"/> 
<delete di r="${yaps . home}/cl asses"/> 
<de1ete di r="${yaps . bui 1 d . di r}"/> 
</target> 

<target name="barkbank-cl ean"> 

<echo message="Cl eans the BarkBank envi ronment"/> 
<delete di r="${barkbank . home}/cl asses"/> 
<delete di r="${barkbank . bui 1 d . di r}"/> 
<delete di r=" $ {barkbank. gene rated. s re .di r}"/> 
</target> 

<target name="petex-dean"> 

<echo message="Cl eans the PetEx envi ronment"/> 
<delete di r="${petex.home}/classes"/> 
<del ete di r="${petex. bui Id . di r}"/> 
<delete di r="${petex. generated. src.di r}"/> 

</target> 

<target name="prepare"> 

<antca1 1 target="yaps-prepare"/> 

<antca1 1 target="barkbank-prepare"/> 

<antca1 1 target="petex-prepare"/> 
</target> 

<target name="yaps-prepare"> 

<echo message="Setup the Yaps envi ronment"/> 
<mkdi r di r="${yaps . cl asses . di r}"/> 
<mkdi r di r="${yaps . bui 1 d . di r}/l i b"/> 
</target> 

<target name="barkbank-prepare"> 

<echo message="Setup the Barkbank envi ronment"/> 
<mkdi r di r=" ${ barkbank. classes .di r}"/> 
<mkdi r di r="${ barkbank. bui Id .di r}"/> 
<mkdi r di r="${ barkbank. generated . sre . di r}"/> 
</target> 
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<target name="petex-prepare"> 

<echo message="Setup the PetEx envi ronment"/> 
<mkdi r di r="${petex . cl asses . di r}"/> 
<mkdi r di r="${petex . bui 1 d . di r}"/> 
<mkdi r di r="${petex . generated . src . di r}"/> 
</target> 



Creation des repertoires de travail de Implica- 
tion PetEx. 



<target name="compi1e" depends="prepare"> 
<antcal 1 target="yaps-compi "I e"/> 
<antcal 1 target="barkbank-compi 1 e"/> 
<antcal 1 target="petex-compi 1 e"/> 

</target> 



< Compile le code source des applications YAPS 
Pet Store, Barkbank et PetEx. 



<target name="yaps-compi1e" depends="yaps-prepare"> 
<echo message="Compile the YAPS generated classes"/> 
<javac srcdi r=" $ {yaps .generated. src. di r}" 
destdi r="${yaps. classes. di r}" 
deprecation="on"> 
<classpath refid="classpath"/> 
<cl asspath refid="yaps-cl asspath "/> 
</javac> 

<echo message="Compile the YAPS classes"/> 
<javac srcdi r="${yaps .srcdi r}" 
destdi r="${yaps. classes. di r}" 
deprecation="on"> 
<compi 1 erarg val ue="-Xl i nt : unchecked"/> 
<classpath refid="classpath"/> 
<classpath refid="yaps-cl asspath "/> 

</javac> 
</target> 



Compile le code source de I'application YAPS 
Pet Store. 



<target name="barkbank-compi1e" depends="barkbank-prepare"> 
<echo message="Compile the BarkBank classes"/> 
<javac srcdi r="${ barkbank. srcdi r}" 
destdi r="${barkbank. cl asses .di r}" 
deprecation="on"> 
<classpath ref i d="cl asspath"/> 
<cl asspath ref i d="barkbank-cl asspath"/> 

</javac> 
</target> 



Compile le code source de I'application Bark- 
Bank. 



<target name="petex-compile" depends="petex-prepare"> < Compile le code source de I'application PetEx. 

<echo message="Compile the Petex classes"/> 
<javac srcdi r="${petex. srcdi r}" 
destdi r="${petex. classes. di r}" 
deprecation="on"> 
<classpath ref i d="cl asspath"/> 
<cl asspath ref i d="petex-cl asspath"/> 

</javac> 
</target> 
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Compile le code source de I'application YAPS 
Pet Store, 



Package les applications YAPS Pet Store, Bark- 
bank et PetEx. 



Package I'application YAPS Pet Store. 



Cree le JAR client. 



Cree le JAR contenant les stateless beans. 



<target name="yaps-compil e" depends="yaps-prepare"> 
<echo message="Compi 1 e the YAPS generated classes"/> 
<javac srcdi r="${yaps . generated . src . di r}" 
destdi r="${yaps . cl asses . di r}" 
deprecation="on"> 
<classpath refid="classpath"/> 
<classpath refid="yaps-classpath"/> 
</javac> 

<echo message="Compile the YAPS classes"/> 
<javac srcdi r="${yaps. srcdi r}" 
destdi r="${yaps . cl asses . di r}" 
deprecation="on"> 
<compi 1 erarg val ue="-Xl i nt : unchecked"/> 
<classpath refid="classpath"/> 
<classpath refid="yaps-classpath"/> 

</javac> 
</target> 

<target name="bui1d" depends="compile"> 

<antcal 1 target="yaps-bui 1 d"/> 

<antcal 1 target="barkbank-bui 1 d"/> 

<antcal 1 target="petex-bui 1 d"/> 
</target> 

<target name="yaps-build" 

depends="yaps-compi le,yaps-bui 1 d-client- jar, yaps -bui ld- 
statel ess- jar ,yaps-bui 1 d-stateful -jar, yaps- bui 1 d-mdb- jar , yaps- 
build-entity- jar ,yaps-bui 1 d-uti 1 ity- jar , yaps -bui 1 d-ws- 
jar, yaps -bui ld-war, yaps-build -ear "/> 

<target name="yaps-build-c1 ient- jar"> 

<echo message="Creates the Client jar"/> 
<jar jarf i 1 e="${yaps . cl i ent . jar}"> 
<f i 1 eset di r="${yaps . cl asses . di r}"> 

<i ncl ude name="com/yaps/petstore/cl i ent/**/* . cl ass"/> 
<i ncl ude name="com/yaps/petstore/enti ty/**/* . cl ass"/> 
<i ncl ude name="com/yaps/petstore/uti 1 /**/* . cl ass"/> 
<i ncl ude name="com/yaps/petstore/exception/**/* ■ class"/> 
<i ncl ude 

name="com/yaps/petstore/statel ess/**/*Remote . cl ass"/> 

<i ncl ude name="org/**/* . cl ass"/> 
</fileset> 

</jar> 
</target> 

<target name="yaps-build-state1ess-jar"> 

<echo message="Creates the EJB stateless jar"/> 

<jar jarfile="${yaps . statel ess . jar}"> 
<f i 1 eset di r="${yaps . cl asses . di r}"> 

<i ncl ude name="com/yaps/petstore/statel ess/**/* . cl ass"/> 
</fi 1 eset> 

</jar> 
</target> 
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<target name="yaps-build-stateful -jar"> 

<echo message="Creates the EJB Stateful jar"/> 

<jar jarfile="${yaps.stateful . jar}"> 
<fi leset di r="${yaps . classes .di r}"> 

<i ncl ude name="com/yaps/petstore/stateful /**/*. class"/> 
</fileset> 

</jar> 
</target> 

<target name="yaps-build-mdb- jar"> 

<echo message="Creates the EJB MDB jar"/> 

<jar jarfi 1 e="${yaps . mdb. jar}"> 
<fi 1 eset di r="${yaps . classes .di r}"> 

<i ncl ude name=" com/yaps/ petstore/mdb/**/* ■ cl ass"/> 
</fileset> 

</jar> 
</target> 

<target name="yaps-build-entity-jar"> 

<echo message="Creates the EJB Entity jar"/> 

<jar j arf i 1 e="${yaps. entity. jar} "> 
<fi leset di r="${yaps . classes. di r}"> 

<i ncl ude name=" com/yaps/ petstore/enti ty/**/* . cl ass"/> 
</fileset> 

<fi 1 eset di r="${yaps . conf i g . di r}"> 

<i ncl ude name="META-INF/ persi stence . xml "/> 

</fileset> 
</jar> 

</target> 

<target name="yaps-build-util ity-jar"> 

<echo message="Creates the Utility jar"/> 

<jar j arf i 1 e=" $ {yaps. u ti 1 ity. jar} "> 
<fi leset di r="${yaps . classes. di r}"> 

<i ncl ude name="com/yaps/petstore/uti l/**/* . class"/> 

<i ncl ude name="com/yaps/petstore/excepti on/**/* ■ cl ass"/> 
</fileset> 

</jar> 
</target> 

<target name="yaps-build-ws-jar"> 

<echo message="Creates the WebService jar"/> 

<jar jarfi 1 e="${yaps .ws . jar}"> 
<fi leset di r="${yaps . classes. di r}"> 

<i ncl ude name="com/barkbank/**/* . cl ass"/> 

<i ncl ude name="com/petex/**/* . cl ass"/> 
</fileset> 

</jar> 
</target> 



< Cree le JAR contenant le stateful bean. 



i Cree le JAR contenant les message-driven beans. 



i Cree le JAR contenant les entities. 



< Cree le JAR contenant les classes utilitaires. 



< Cree le JAR contenant les artefacts des services 
web. 
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Cree le WAR contenant I'application web. ► <target name="yaps-build-war"> 

<echo message="Creates the PetStore Web Application"/> 

<war destfile="${yaps.war}" 

webxml="${yaps .web-i nf . di r}/web . xml " 
<fi 1 eset di r="${yaps .web . di r}"> 

<i ncl ude name="**/*. jsp"/> 

<i ncl ude name="**/*- jspf"/> 

<i ncl ude name="**/*-gif"/> 

<include name="**/*. jpg"/> 

<i ncl ude name="**/* ■ css"/> 
</fileset> 

<webinf di r="${yaps .web-i nf .di r}"> 

<i ncl ude name="f aces-conf i g . xml "/> 
</webi nf > 

<cl asses di r="${yaps . cl asses . di r}"> 

<i ncl ude name="com/yaps/petstore/jsf/**/* . cl ass"/> 

</classes> 
</war> 

</target> 

Cree le EAR contenant toutes les librairies. 1 ► <target name="yaps-build-ear"> 

<echo message="Creates the PetStore Enterprise Application"/ 
<delete f i 1 e="${yaps . ear}"/> 

<jar jarfile="${yaps.ear}" basedi r="${yaps . bui Id . di r}" 

excl udes="${appl i cati on . name} . jar"/ 

</target> 

Package I'application BarkBank. 1 ► <target name="barkbank-build" depends="barkbank- 

compi 1 e , barkbank-generate-server-arti facts"> 

<echo message="Creates the Barkbank Web Application"/> 
<war destfi 1 e="$ {barkbank. war}" 

webxml="${ barkbank. web-i nf . di r}/web . xml " 
<fileset di r="${barkbank.web.di r}"> 
<include name="**/*. jsp"/> 
<include name="**/* . gi f "/> 
</fileset> 

<cl asses di r=" ${ barkbank. classes. di r}"> 
<i ncl ude name="com/barkbank/**/* . cl ass"/> 

</classes> 
</war> 

</target> 

Package I'application PetEx. 1 ► <target name="petex-build" depends="petex-compi 1 e , 

petex-generate-server-arti facts" 
<echo message="Creates the Petex Web Application"/> 
<war destfile="${petex.war}" 

webxml="${petex.web-inf .di r}/web.xml " 
<f i 1 eset di r="${ petex. web . di r}"> 
<i ncl ude name="**/*. jsp"/> 
<i ncl ude name="**/*.gif"/> 
</f i 1 eset> 

<cl asses di r="${ petex. classes . di r}"> 
<i ncl ude name="com/petex/**/* ■ cl ass"/> 

</classes> 
</war> 

</target> 
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<target name="generate-server-arti f acts"> 

ontcall target=" bar kbank-gene rate- serve r-artif acts "/> 
<antcall target="petex-generate-server-arti facts "/> 
</target> 



Genere les artefacts serveur des services web de 
BarkBank et PetEx. 



<target name="barkbank-generate-server-arti facts" 

depends="barkbank-compi le"> 
<echo message="Cenerates the BarkBank artifacts"/> 
<exec executable="${wsgen}" failonerror="true"> 



org 
org 
org 
org 
org 1 
org 1 
org line= 

</exec> 
</target> 



ne= 
ne= 
ne= 
ne= 
ne= 
ne= 



-cp ${barkbank. classes. di r}"/> 
-d ${barkbank. classes. dir}"/> 
-keep"/> 
-wsdl "/> 

-r ${ bar kbank. gene rated. src.di r}"/> 
-s ${ bar kbank. generated . src . di r}"/> 
com . barkbank . val i dator . Val i dati on"/> 



Genere les artefacts serveur du service web de 
BarkBank. 



<target name="petex-generate-server-arti facts" 

depends="petex-compile"> 
<echo message="Generates the Petex artifacts"/> 
<exec executabl e="${wsgen}" failonerror="true"> 



org I 

org 1 

org 1 

org 1 

org 1 

org 1 



ne= 
ne= 
ne= 
ne= 
ne= 
ne= 



org line= 

</exec> 
</target> 



-cp ${petex . cl asses . di r}"/> 
-d ${petex. classes. di r}"/> 
-keep"/> 
-wsdl"/> 

-r ${petex. generated. src.di r}"/> 
-s ${petex. generated. src.di r}"/> 
com . petex .transport . Del i very"/> 



Genere les artefacts serveur du service web de 
PetEx. 



<target name="generate-c"Hent-artifacts"> 

ontcal 1 target="barkbank-generate-cl i ent-arti f acts"/> 
<antcal 1 target="petex-generate-cl i ent-arti f acts"/> 
</target> 



Genere les artefacts client des services web de 
BarkBank et PetEx. 



<target name="barkbank-generate-d ient-arti facts" 

depends="yaps-prepare' 
<echo message="Generates client artifacts for Bark Bank"/> 
<exec executable="${wsimport}" failonerror="true"> 

org line=" -d ${yaps . cl asses . di r}"/> 

org line=" -keep"/> 

org line=" -s ${yaps . generated . src . di r}"/> 

org line=" http://${server.host}:${server.port}/barkbank/ 

Val i dati onSe rvi ce?WSDL"/> 

</exec> 
</target> 



Genere les artefacts client du service web de 
BarkBank. 
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Genere les artefacts client du service web de 
PetEx. 



Deploiement des applications YAPS Pet Store, 
BarkBank et PetEx. 



Deploiement de I'application YAPS Pet Store et 
insertion des donnees en base. 



Deploiement de I'application BarkBank. 



<target name="petex-generate-c1 ient-arti facts" 

depends="yaps-prepare' 
<echo message="Generates client artifacts for PetEx"/> 
<exec executabl e="${wsi mport}" failonerror="true"> 

org line=" -d ${yaps . cl asses . di r}"/> 

<arg line=" -keep"/> 

<arg line=" -s ${yaps . generated . src . di r}"/> 

<arg line=" http ://${server . host} : ${server . port}/petex/ 

Del i veryServi ce?WSDL"/> 

</exec> 
</target> 

<target name="dep"loy"> 

<antcal 1 target="barkbank-bui 1 d"/> 
ontcal 1 target="barkbank-deploy"/> 

ontcal 1 target="barkbank-generate-cl i ent-arti facts"/> 
ontcal 1 target="petex-bui 1 d"/> 
ontcall target="petex-deploy"/> 

ontcal 1 target="petex-generate-cl i ent-arti f acts"/> 
ontcal 1 target="yaps-bui 1 d"/> 
ontcall target="yaps-deploy"/> 
</target> 

<target name="yaps-deploy"> 

<echo message="Deploys the YAPS appl i cati on"/> 
<exec executabl e="${asadmi n}"> 



<arg 


li 


ne=' 


'deploy"/> 


<arg 


li 


ne=' 


' --echo=${echo}"/> 


<arg 


li 


ne=' 


' --user ${server.user.name}"/> 


<arg 


li 


ne=' 


' --passwordfile ${server.passwordfile}"/> 


<arg 


li 


ne=' 


' --host ${server.host}"/> 


<arg 


li 


ne=' 


' --port ${server . admi n . port}"/> 


<arg 


li 


ne=' 


' ${yaps.ear}"/> 



</exec> 

ontcall target="db-i nsert-data"/> 
</target> 

<target name="barkbank-dep"loy"> 

<echo message="Deploys the BarkBank application"/> 
<exec executabl e="${asadmin}"> 



<arg 1 
<arg 1 
<arg 1 
<arg 1 
<arg 1 
<arg 1 
<arg line= 
</exec> 
</target> 



ne= 
ne= 
ne= 
ne= 
ne= 
ne= 



deploy"/> 
— echo=${echo}"/> 
--user ${server.user.name}"/> 
--passwordf i 1 e ${server . passwordf i 1 e}"/> 
--host ${server . host}"/> 
--port ${server. admin. port}"/> 
${barkbank.war}"/> 
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<target name="petex-deploy"> 

<echo message="Depl oys the PetEx application"/> 
<exec executabl e="${asadmi n}"> 



< Deploiement de I'application PetEx. 



deploy"/> 
--echo=${echo}"/> 
--user ${server.user.name}"/> 
--passwordfile $ {server . passwordfi1e}"/> 
--host ${server.host}"/> 
--port ${server. admin. port}"/> 
${petex.war}"/> 



org line= 
org line= 
org line= 
org line= 
org line= 
org line= 
org line= 

</exec> 
</target> 

<target name="undep"loy"> 

ontcal 1 target="yaps-undepl oy"/> 
<antcal 1 target="barkbank-undep"loy"/> 
ontcall target="petex-undeploy"/> 
</target> 

<target name="yaps-undep"loy"> 

<echo message="Undep1oys the YAPS application"/> 
<exec executabl e="${asadmi n}"> 
ine="undeploy"/> 
ine=" --echo=${echo}"/> 
ine=" --user ${server . user . name}"/> 
ine=" --passwordfile ${server.passwordfi1e}"/> 
ine=" --host ${server . host}"/> 
ine=" --port ${server . admi n . port}"/> 
ine=" ${application.name}"/> 
</exec> 
</target> 

<target name="barkbank-undep"loy"> 

<echo message="Undep"loys the BarkBank application"/> 
<exec executabl e="${asadmin}"> 



Suppression des applications YAPS Pet Store, 
BarkBank et PetEx. 



< Suppression de I'application YAPS Pet Store. 



org 


V 


ne= 


org 


1 


ne= 


org 


1- 


ne= 


org 


1- 


ne= 


org 


1 


ne= 


org 


1 


ne= 


org 


1 i ne= 



< Suppression de I'application BarkBank. 



org line= 
org line= 
org line= 
org line= 
org line= 
org line= 
org line= 

</exec> 
</target> 

<target name="petex-undeploy"> 

<echo message="Undeploys the PetEx app"lication"/> 
<exec executabl e="${asadmin}"> 



undeploy"/> 
— echo=${echo}"/> 
--user ${server . user . name}"/> 
--passwordf i le $ {server . passwordf i le}"/> 
--host ${server . host}"/> 
--port ${server.admin.port}"/> 
barkbank"/> 



< Suppression de I'application PetEx. 



org 1 
org 1 
org 1 
org 1 
org 1 
org 1 
org line= 

</exec> 
</target> 



ne= 
ne= 
ne= 
ne= 
ne= 
ne= 



undeploy"/> 
--echo=$ {echo} "/> 
--user ${server . user . name}"/> 
--passwordf i 1 e $ {server . passwordf i 1 e}"/> 
--host ${server.host}"/> 
--port ${server. admin. port}"/> 
petex"/> 
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Verifie les applications YAPS Pet Store, BarkBank 
et PetEx. 



Verifie I'application YAPS Pet Store. 



Verifie I'application BarkBank. 



Verifie I'application PetEx. 



Affiche les composants deployes sur le serveur 
GlassFish. 



Execute I'application cliente. 



<target name="verify"> 

<antcal 1 target="yaps-veri fy"/> 
<antcal 1 target="barkbank-veri fy"/> 
<antcal 1 target="petex-veri fy"/> 

</target> 

<target name="yaps-verify"> 
<mkdi r di r="${verifier.di r}"/> 
<exec executabl e="${veri f i er}"> 

<arg line=" -d ${veri fi er . di r}"/> 

<arg line=" ${yaps . ear}"/> 
</exec> 

</target> 

<target name="barkbank-veri fy"> 
<mkdi r di r="${verifier.di r}"/> 
<exec executabl e="${veri f i er}"> 

<arg line=" -d ${veri fi er . di r}"/> 

<arg line=" ${barkbank.war}"/> 
</exec> 

</target> 

<target name="petex-verify"> 
<mkdi r di r="${verifier.di r}"/> 
<exec executabl e="${veri f i er}"> 

<arg line=" -d ${veri fi er . di r}"/> 

<arg line=" ${petex.war}"/> 
</exec> 

</target> 

<target name="show"> 

<exec executabl e="${asadmi n}"> 



<arg 1 
<arg 1 
<arg 1 
<arg 1 
<arg 1 
<arg 1 
<arg line^ 
</exec> 
</target> 



ne= 
ne= 
ne= 
ne= 
ne= 
ne= 



show- component- status "/> 
--echo=${echo}"/> 
--user ${server.user.name}"/> 
--passwordfile ${server . passwordf i 1 e}"/> 
— host ${server.host}"/> 
--port ${server. admin. port}"/> 
${appl i cati on . name}"/> 



<target name="run-c1 ient" 

depends="yaps-compi 1 e ,yaps-bui 1 d-cl ient- jar 
<echo message="Runs the client application"/> 
<java classname="com. yaps. petstore. client. ui . PetstoreFrame' 

fork="yes" di r=" . 

<classpath> 

<pathelement 1 ocation="${yaps . cl i ent . jar}"/> 

<path refid="classpath"/> 
</classpath> 

</java> 
</target> 
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<target name="db-insert-data"> < Insere des donnees dans la base. 

<sql src="${yaps . config .di r}/data.sql " 
dri ver="${db .driver}" 
url="${db.url}" 
userid="${db.user}" 
password="${db. pas sword} "> 
<classpath ref i d="cl asspath"/> 

</sql> 
</target> 



<target name="core" depends="cl ean , bui 1 d"/> < 
</project> 



La tache principale supprime les repertoires tem- 
poraires, compile toutes les applications et les 
package. 



Admin.xml 

Dans ce fichier, vous trouverez les taches d'administration du serveur GLASSFlSH Administration 

GlassFish. La plupart utilise la commande asadmi n de GlassFish. Pour PoU r obtenir de la documentation sur I'administra- 
les executer, il suffit de taper la ligne de commande suivante : tion de GlassFish : 

► http://docs.sun.com/app/docs/doc/819-3658 

ant -f admin.xml <le nom de la tache> 

Vous trouverez dans le fichier ci-dessous la liste des taches d'administra- 
tion que vous pouvez executer. 

<?xml version="1.0"?> 

<project name="Admin Petstore" defaul t="l i st" basedir="."> 

<property name="appl i cation. name" val ue="petstore"/> 
<property name="home . di r" val ue="${basedi r}"/> 
<property name="lib.di r" val ue="${home . di r}/l i b"/> 



< Variables globales de I'application. 



<property envi ronment="env"/> 
<property name="gl assfi sh . home" 

value="${env.GLASSFISH_HOME}"/> 
<property name="asadmi n" 

val ue="${gl assfi sh . home}/bi n/asadmi n . bat"/> 
<property name="echo" val ue="fal se"/> 



Variables d'environnement et utilitaires d'admi- 
nistration et de generation de GlassFish. 



<property name="server. host" value="localhost"/> < I Proprietes du serveur GlassFish. 

<property name="server. port" val ue="8080"/> 

<property name="server . admi n . port" val ue="8282"/> 

<property name="server . jms . port" val ue="7676"/> 

<property name="server . user . name" val ue="admi n"/> 

<property name="server.passwordfile" val ue="passwordfi 1 e"/> 



<property name="db . home" value="${gl assfi sh . home}/javadb"/> < Proprietes de la base de donnees Derby. 

<property name="db . 1 i b" value="${db.home}/lib"/> 

<property name="db . host" val ue="local host"/> 

<property name="db . port" val ue="1527"/> 
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Proprietes de la source de donnees et du pool 
JDBC. 



Proprietes JMS. 



JAR utilises pour administrer I'application. ► 



Demarre le serveur GlassFish. 



Arrete le serveur GlassFish. 



<property name="db . si d" value="${application.name}DB"/> 
<property name="db . user" val ue="dbuser"/> 
<property name="db . password" val ue="dbpwd"/> 
<property name="db . datasource" 

val ue="org . apache . derby . j dbc . CI i entDataSou rce"/> 
<property name="db . driver" 

val ue="org . apache . de rby . j dbc . CI i entDri ver"/> 
<property name="db . url " 

val ue="j dbc: derby ://${db. host} :${db.port}/${db. si d}"/> 
<property name="db. schema. file" val ue="${db. sid} . schema"/> 

<property name=" jdbc . pool .name" 

val ue="${appl i cation . name} Pool "/> 
<property name=" jdbc . datasource . name" 

val ue=" jdbc/${appl i cati on . name}DS"/> 

<property name="imq.home" value="${glassfish.home}/imq"/> 
<property name="imq.lib" value="${imq.home}/lib"/> 
<property name=" jms . connecti on . factory . name" 

val ue=" jms/${appl i cati on . name}Connecti on Facto ry"/> 
<property name=" jms . topi c" val ue=" jms/topi c/order"/> 

<path id="classpath"> 

<pathel ement 1 ocati on="${db . 1 i b}/derbytool s . jar"/> 
<pathelement 1 ocati on="${db . 1 i b}/derbycl i ent . jar"/> 
<pathel ement 1 ocati on="${db . 1 i b}/derby . jar"/> 

</path> 

<target name="start-domain"> 

<echo message="Starti ng ${appli cati on. name} domain for 

${gl assf i sh . home}"/> 
<exec executabl e="${asadmi n}" failonerror="true" 

dir="${glassfish.home}"> 

org line=" start-domai n"/> 
org line=" --echo=${echo}"/> 
org line=" ${application.name}"/> 
</exec> 
</target> 

<target name="stop-domain"> 

<echo message="Stoppi ng ${appli cati on. name} domain for 

${gl assf i sh . home}"/> 
<exec executable="${asadmin}" failonerror="true" 

di r="${glassfi sh . home}"> 

org line=" stop-domai n"/> 
org line=" --echo=${echo}"/> 
org line=" ${application.name}"/> 
</exec> 
</target> 
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<target name="delete-domain"> 

<echo message="Del eti ng ${appli cation. name} domain for 

${gl assf i sh . home}"/> 
<exec executabl e="${asadmi n}" fai lonerror="true" 

dir="${glassfish.home}"> 

<arg line=" del ete-domai n"/> 
<arg line=" --echo=${echo}"/> 
<arg line=" ${application.name}"/> 
</exec> 
</target> 

<target name="start-db"> 

<exec executable="${asadmin}" fai lonerror="true" 

di r="${glassfish.home}"> 

<arg val ue="start-database"/> 
<arg line=" --echo=${echo}"/> 
<arg val ue="--dbhost=${db . host}"/> 
<arg val ue="--dbport=${db . port}"/> 
<arg val ue="--dbhome=${db . home}"/> 
</exec> 
</target> 

<target name="stop-db"> 

<exec executable="${asadmin}" fai lonerror="true" 

di r="${glassfish.home}"> 

org val ue="stop-database"/> 
<arg line=" --echo=${echo}"/> 
<arg val ue="--dbhost=${db . host}"/> 
<arg val ue="--dbport=${db . port}"/> 
</exec> 
</target> 

<target name="verify-db"> 

<java classname="org. apache. derby. tools. sysinfo" fork="yes" 

dir="."> 

<classpath refi d="cl asspath"/> 
</java> 
</target> 

<target name="create-connection-poo1 "> 

<exec executabl e="${asadmin}"> 



<arg 


1 


ne=' 


create- jdbc-connecti on-pool "/> 


<arg 


1 


ne=' 


--echo=${echo}"/> 


<arg 


1 


ne=' 


--user ${server . user . name}"/> 


<arg 


1 


ne=' 


--passwordf i 1 e ${server . passwordf i 1 e}"/> 


<arg 


1 


ne=' 


--host ${server.host}"/> 


<arg 


1 


ne=' 


--port ${server. admin. port}"/> 


org 


1 


ne=' 


--datasourceclassname ${db.datasource}"/> 


org 


1 


ne=' 


--restype javax.sql .XADataSource"/> 


org 


1 i ne=' 


--property 



portNumber=${db . port} : serverName=$ {server . host} : 
Use r=${db. user} : Password=${db . password} : 
databaseName=${db . si d} : 
connectionAttri butes=\;create\=true"/> 
org line=" ${ jdbc . pool . name}"/> 
</exec> 
</target> 



i Supprime le domaine GlassFish. 



< Demarre la base de donnees Derby. 



i Arrete la base de donnees Derby. 



< Verifie la base de donnees Derby. 



< Cree le pool de connexions. 



Cree la source de donnees. 



Ping le pool de connexions. 



Affiche la liste des pools de connexions. 



Affiche la liste des sources de donnees. 



<target name="create-datasource"> 

<exec executabl e="${asadmi n}"> 



org 


V 


ne=' 


create- jdbc-resource"/> 


<arg 


V 


ne=' 


— echo=${echo}"/> 


org 


V 


ne=' 


--user ${server.user.name}"/> 


<arg 


1 


ne=' 


--passwordf i 1 e $ {server . passwordf i 1 e}"/> 


<arg 


V 


ne=' 


--host ${server.host}"/> 


<arg 


1- 


ne=' 


--port ${server . admi n . port}"/> 


<arg 


V 


ne=' 


--connectionpool id ${jdbc.pool .name}"/> 


org 


1- 


ne=' 


--enabl ed=true"/> 


<arg 


1 i ne=' 


${jdbc.datasource.name}"/> 



org 


1 


ne= 


org 


1 


ne= 


org 


V 


ne= 


org 


1- 


ne= 


org 


1- 


ne= 


org 


1- 


ne= 


org 


1 i ne= 



</exec> 
</target> 

<target name="ping-connection-pool "> 

<exec executabl e="${asadmi n}"> 

ine="ping-connection-pool "/> 
ine=" --echo=${echo}"/> 
ine=" --user ${server . user . name}"/> 
ine=" --passwordf i 1 e ${server.passwordfile}"/> 
ine=" --host ${server . host}"/> 
ine=" --port ${server . admi n . port}"/> 
ine=" ${jdbc.pool .name}"/> 
</exec> 
</target> 

<target name="1ist-connection-poo1 "> 

<exec executabl e="${asadmin}"> 

ine="l i st-jdbc-connection-pools"/> 
ine=" --echo=${echo}"/> 
ine=" --user ${server . user . name}"/> 
ine=" --passwordf i 1 e ${server.passwordfile}"/> 
ine=" --host ${server . host}"/> 
ine=" --port ${server . admi n . port}"/> 
</exec> 
</target> 

<target name="1 i st-datasource"> 

<exec executabl e="${asadmi n}"> 



org 


1 


'ne= 


org 


1 


ne= 


org 


1 


'ne= 


org 


1 


" ne= 


org 


1 


'ne= 


org 


1 i ne= 



org 


li 


ne=' 


1 i st-jdbc-resources"/> 


org 


li 


ne=' 


— echo=${echo}"/> 


org 


li 


ne=' 


--user ${server . user . name}"/> 


org 


li 


ne=' 


--passwordf i 1 e $ {server . passwordf i le}"/> 


org 


li 


ne=' 


--host ${server . host}"/> 


org 


li 


ne=' 


--port ${server.admin.port}"/> 



</exec> 
</target> 
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<target name="delete-connection-poo"l "> < Supprime le pool de connexions. 

<exec executabl e="${asadmi n}"> 



<arg 


V 


ne= 


'del ete- jdbc-connection-pool "/> 


<arg 


1 


ne= 


' --echo=${echo}"/> 


<arg 


1 


ne= 


' --user ${server.user.name}"/> 


<arg 


1 


ne= 


' --password-file ${server.passwordfile}"/> 


<arg 


1 


ne= 


' --host ${server.host}"/> 


<arg 


1 


ne= 


' --port ${server. admin. port}"/> 


<arg 


1 i ne= 


'${jdbc.pool .name}"/> 



</exec> 



</target> 



<target name="delete-datasource"> < Supprime la source de donnees. 

<exec executabl e="${asadmi n}"> 

<arg 1 i ne="del ete- jdbc- resource "/> 

<arg line=" --echo=${echo}"/> 

<arg line=" --user ${server . user . name}"/> 

org line=" --passwordfi 1 e ${server.passwordfile}"/> 

<arg line=" --host ${server . host}"/> 

<arg line=" --port ${server . admi n . port}"/> 

<arg 1 i ne="${ jdbc . datasource . name}"/> 
</exec> 
</target> 



<target name="l ist-jndi-resources"> < Affiche toutes les ressources JNDI. 

<exec executabl e="${asadmi n}"> 

<arg 1 i ne="l i st- jndi -resources"/> 

<arg line=" --echo=${echo}"/> 

<arg line=" --user ${server . user . name}"/> 

<arg line=" --passwordfi 1 e ${server.passwordfile}"/> 

<arg line=" --host ${server . host}"/> 

<arg line=" --port ${server . admi n . port}"/> 
</exec> 
</target> 



<target name="list-jndi"> < Affiche I'arborescence JNDI. 

<exec executabl e="${asadmi n}"> 

<arg 1 i ne="l i st- jndi -entri es"/> 

<arg line=" --echo=${echo}"/> 

<arg line=" --user ${server . user . name}"/> 

<arg line=" --passwordfi 1 e ${server . passwordfi 1 e}"/> 

<arg line=" --host ${server . host}"/> 

org line=" --port ${server . admi n . port}"/> 
</exec> 
</target> 
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Cree la fabrique de connexions JMS. 



Cree le Topic JMS. 



Affiche les ressources JMS. 



Supprime la fabrique de connexions JMS. 



<arg li 


ne= 


org li 


ne= 


org li 


ne= 


org li 


ne= 


org li 


ne= 


org li 


ne= 


org li 


ne= 


org li 


ne= 


org li 


ne= 


</exec> 




</target> 





<target name="create- jms-connection-factory"> 

<exec executabl e="${asadmi n}"> 

i ne=" create- jms-resource"/> 
ine=" --echo=${echo}"/> 
ine=" --user ${server . user . name}"/> 
ine=" --passwordfile ${server.passwordfile}"/> 
ine=" --host ${server . host}"/> 
ine=" --port ${server . admi n . port}"/> 
ine=" --restype javax. jms.ConnectionFactory"/> 
ine=" --enabl ed=true"/> 
i ne=" ${ jms . connecti on . factory . name}"/> 



<target name="create- jms- topi c"> 

<exec executabl e="${asadmi n}"> 

'create- jms- resource"/> 
--echo=${echo}"/> 
--user ${server.user.name}"/> 
--passwordf i 1 e $ {server . passwordf i 1 e}"/> 
--host ${server.host}"/> 
--port ${server . admi n . port}"/> 
--restype javax. jms.Topic"/> 
--enabl ed=true"/> 
--property Name=OrderTopi c"/> 
${ jms. topi c}"/> 



<target name=""Hst-jms-resources"> 

<exec executabl e="${asadmin}"> 

i ne="l i st- jms- resources "/> 
ine=" --echo=${echo}"/> 
ine=" --user ${server . user . name}"/> 
ine=" --passwordfile ${server.passwordfile}"/> 
ine=" --host ${server . host}"/> 
ine=" --port ${server . admi n . port}"/> 
</exec> 
</target> 

<target name="delete- jms-connection-factory"> 

<exec executabl e="${asadmin}"> 



org V 


ne= 


org V 


ne= 


org V 


ne= 


org V 


ne= 


org V 


ne= 


org 1" 


ne= 


org V 


ne= 


org V 


ne= 


org V 


ne= 


org line= 


</exec> 




</target> 





org 


1 


" ne= 


org 


1 


' ne= 


org 


1 


' ne= 


org 


1 


'ne= 


org 


1 


'ne= 


org 


1 i ne= 



org 


1 


ne=' 


'delete-jms-resource"/> 


org 


1- 


ne=' 


' --echo=${echo}"/> 


org 


1- 


ne=' 


' --user ${server . user . name}"/> 


org 


1- 


ne=' 


' --passwordfile ${server.passwordfile}"/> 


org 


1 


ne=' 


' --host ${server . host}"/> 


org 


1- 


ne=' 


' --port ${server . admi n . port}"/> 


org 


1 i ne=' 


' ${ jms . connecti on . factory . name}"/> 



</exec> 
</target> 



314 



<target name="set-loggers"> 
<exec executabl e="${asadmi n}"> 

<arg 1 i ne="set"/> 

<arg line=" --echo=${echo}"/> 

<arg line=" --user ${server.user.name}"/> 

<arg line=" --passwordfi 1 e ${server.passwordfile}"/> 

<arg line=" --host ${server . host}"/> 

<arg line=" --port ${server . admi n . port}"/> 

<arg line=" server. log-service. 

modul e-1 og-1 evel s .property . com\ . yaps\ . petstore=FINEST "/> 
</exec> 

<exec executabl e="${asadmin}"> 
<arg line="set"/> 
<arg line=" --echo=${echo}"/> 
<arg line=" --user ${server.user.name}"/> 
<arg line=" --passwordfi 1 e ${server . passwordfi 1 e}"/> 
org line=" --host ${server . host}"/> 
<arg line=" --port ${server . admi n . port}"/> 
<arg line=" server. log-service. 

modul e-1 og-1 evel s .property . com\ . barkbank=FINEST "/> 

</exec> 

<exec executabl e="${asadmi n}"> 
<arg line="set"/> 
<arg line=" --echo=${echo}"/> 
<arg line=" --user ${server . user . name}"/> 
<arg line=" --passwordfi 1 e ${server . passwordfi 1 e}"/> 
<arg line=" --host ${server. host}"/> 
<arg line=" --port ${server . admi n . port}"/> 
<arg line=" server. log-service. 

modul e-1 og-1 evel s . property . com\ . petex=FINEST "/> 

</exec> 
</target> 

<target name="version"> 

<exec executabl e="${asadmi n}"> 

<arg line="version"/> 

<arg line=" --echo=${echo}"/> 

<arg line=" --user ${server . user . name}"/> 

<arg line=" --passwordfi 1 e ${server.passwordfile}"/> 

<arg line=" --host ${server . host}"/> 

<arg line=" --port ${server . admi n . port}"/> 

org line=" --verbose=true"/> 
</exec> 
</target> 



Cree les loggers pour les applications YAPS , 
Pet STore, BarkBank, PetEx. 00 



< Affiche la version du serveur GlassFish. 
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Affiche la liste des composants deployes sur 
GlassFish. 



Affiche la totalite des informations du serveur 
GlassFish. 



Configure le serveur GlassFish. 



<arg 


1 


ne= 


<arg 


1- 


ne= 


org 


V 


ne= 


<arg 


1 


ne= 


org 


V 


ne= 


org 


1 i ne= 



<target name="l i st-components"> 

<exec executabl e="${asadmi n}"> 
i ne="l i st-components"/> 
ine=" --echo=${echo}"/> 
ine=" --user ${server . user . name}"/> 
ine=" --password-file ${server.passwordfile}"/> 
ine=" --host ${server . host}"/> 
ine=" --port ${server . admi n . port}"/> 
</exec> 
</target> 

<target name="list" description="list all components'^ 

ontcal 1 target="l i st-connection-pool "/> 

ontcal 1 target="l i st-datasource"/> 

ontcal 1 target="l i st-jms- resources "/> 

ontcall target="list-jndi"/> 

ontcal 1 target="l i st-components"/> 
</target> 

<target name="setup"> 



ontcall 
ontcall 
ontcall 
ontcall 
ontcal 1 
ontcall 
</target> 



target="create-connecti on-pool "/> 

target="pi ng-connection-pool "/> 

target="create-datasource"/> 

target=" create- jms -connect! on -facto ry"/> 

target="create- jms-topi c"/> 

target="set-loggers"/> 



</project> 
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Sigles et acronymes 



C 



Le monde de l'informatique, et plus particulierement Java, est parseme 
d'une multitude de sigles et d'acronymes en tout genre. Vous trouverez 
ci-apres une liste non exhaustive de ceux rencontres les plus frequem- 
ment dans la litterature informatique. 



Tableau C-1 Sigles et acronymes 




ACC 


Application Client Container 


Ant 


Another Neat Tool 


API 


Application Programming Interface 


ASP 


Active Server Page 


AWT 


Abstract Windowing Toolkit 


B2A 


Business to Administration 


B2B 


Business to Business 


B2C 


Business to Consumer 


BLOB 


Binary Large OBject 


BMP 


Bean-Managed Persistence 


C2C 


Consumer to Consumer 


CGI 


Common Gateway Interface 


CMP 


Container-Managed Persistence 


CMR 


Container-Managed Relation 


CMT 


Container-Managed Transaction 


CRUD 


Create/Read/Update/Delete 


DAO 


Data Access Object 


DDL 


Data Definition Language 



Tableau C-1 Sigles et acronymes (suite) 



Sigle/Acronyme 


Signification 


DOM 


Document Object Model 


DTD 


Document Type Definition 


DTO 


Data Transfer Object 


EAR 


Enterprise ARchive 


EJB 


Enterprise Java Bean 


EJBQL 


Enterprise Java Bean Query Language 


EL 


Expression Language 


FCS 


First Customer Shipment 


GoF 


Gang of Four 


HTML 


Hypertext Markup Language 


HTTP 


Hypertext Transfer Protocol 


HTTPS 


Hypertext Transfer Protocol Secure (sockets) 


11 8n 


Internationalization 


IDE 


Integrated Development Environment 


loC 


Inversion of Control 


IP 


Internet Protocol 


JAAS 


Java Authentication and Authorization Service 


JACC 


Java Authorization Contract for Containers 


JAF 


JavaBeans Activation Framework 


JAR 


Java ARchive 


JAX-RPC 


Java API for XML-based RPC 


JAX-WS 


Java API for XML-based Web Services 


JAXB 


Java Architecture for XML Binding 


JCA 


Java Connector Architecture 


JDBC 


Java DataBase Connectivity 


JDK 


Java Development Kit 


JDO 


Java Data Object 


Java EE (ou J EE) 


Java Enterprise Edition 


JMS 


Java Message Service 


JNDI 


Java Naming Directory Interface 


J PA 


Java Persistence API 


JRE 


Java Runtime Environment 


JRMP 


Java Remote Method Protocol 


Java SE (ou JSE) 


Java Standard Edition 


JSF 


JavaServer Faces 


JSP 


JavaServer Pages 
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Tableau C-1 Sigles et acronymes (suite) 



Sigle/Acronyme 


Signification 


JSR 


Java Specification Request 


JSTL 


JSP Standard Tag Library 


JTA 


Java Transaction API 


JVM 


Java Virtual Machine 


LDAP 


Lightweight Directory Access Protocol 


MIME 


Multipurpose Internet Mail Extensions 


MOM 


Message-Oriented Middleware 


ODBC 


Open DataBase Connectivity 


OMG 


Object Management Group 


PDA 


Personal Digital Assistant 


PHP 


PHP Hypertext Preprocessor 


POJO 


Plain Old Java Object 


RC 


Release Candidate 


RMI 


Remote Method Invocation 


RPC 


Remote Procedure Call 


SAAJ 


SOAP with Attachments API for Java 


SAX 


Simple API for XML 


SGML 


Standard Generalized Markup Language 


SOAP 


Simple Object Access Protocol 


SQL 


Structured Query Language 


SSL 


Secure Socket Layer 


SSO 


Single Sign-On 


StAX 


Streaming API for XML 


TCP 


Transmission Control Protocol 


UDDI 


Universal Description, Discovery and Integration 


UDP 


User Datagram Protocol 


UEL 


Unified Expression Language 


UML 


Unified Modeling Language 


UR 


Update Release 


URC 


Uniform Resource Characteristic 


URI 


1 1 ■ t' In i 1 ■ f" 

Unified Resource Identifier 


URL 


Uniform Resource Locator 


URN 


Uniform Resource Name 


WAP 


Wireless Application Protocol 


WAR 


Web ARchive 


WML 


Wireless Markup Language 
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Tableau C-1 Sigles et acronymes (suite) 



Sigle/Acronyme 


Signification 


WSDL 


Web Service Description Language 


XML 


extended Markup Language 


XSL 


extensible Stylesheet Language 


XSLT 


extensible Stylesheet Language Transformations 


YAPS 


Yet Another PetStore 



320 



EJB 2 



D 



//. Entity Bean et Entity 

Les EJB 2.x utilisent le terme d'entity bean pour 
definir les composants persistants. Avec JPA, on 
parle plutot tout simplement d'entity (ou entite). 



OUTILS Base de donnees MySQL 

MySQL est un serveur de base de donnees rela- 
tionnelle, multithreade, multi-utilisateurs et 
robuste. II dispose de deux licences : Open Source, 
sous les termes de la licence GNU GPL (General 
Public License), ou alors une licence commer- 
ciale achetee aupres de MySQL AB. 
► http://www.mysql.com 



OuilLS Serveur d'applications JBoss 

JBoss est un serveur d'applications Open Source 
certifie J2EE. Historiquement specialise pour les 
EJB, son architecture modulaire lui permet de 
repondre aux autres specifications J2EE : JBoss 
Server est le conteneur d'EJB, JBoss MQ gere les 
messages (JMS), JBoss MX la messagerie electro- 
nique, JBoss TX les transactions JTA/JTS, JBoss SX la 
securite, JBoss CX la connectivity JCA et JBoss CMP 
la persistance CMP. Pour les JSP/servlets, JBoss 
integre Tomcat. 
► http://www.jboss.com/ 



« Java EE 5 est plus simple que J2EE 1.4 ». Voila une phrase qui revient 
assez souvent dans ce livre. Pour vous le prouver, cette annexe se focalise 
sur les EJB et se propose de vous expliquer comment developper un sta- 
teless bean et un entity bean en version 2.1. Nous prendrons deux exem- 
ples extremement simples de type « Hello World » qui vous permettront 
de comprendre les differences entre les EJB 2 et les EJB 3. 

Pour changer un peu de configuration, ces EJB utilisent des fichiers de 
deploiement pour le serveur d'applications JBoss et la base MySQL. 



Un exemple d'entity bean 

Les entity beans 2.x se declinent en deux modeles de persistance : 

• au niveau du composant (BMP : Bean-Managed Persistence) ; 

• au niveau du conteneur (CMP : Container-Managed Persistence). 

La persistance d'un BMP est implementee par le developpeur. Ce der- 
nier a en charge le developpement de la logique necessaire pour inserer 
les donnees en base, les mettre a jour, les supprimer et instancier un EJB 
a partir de ces donnees. Cela necessite habituellement d'ecrire du code 
JDBC. Avec cette gestion de persistance, le developpeur a un controle 
total sur la maniere dont les acces a la base sont realises. 

La persistance d'un CMP est assuree par le conteneur d'EJB. A travers une 
configuration specifiee dans un descripteur de deploiement, le conteneur 
d'EJB fera correspondre les attributs de 1'entity bean avec les colonnes 
d'une table. Lutilisation des CMP reduit le temps de developpement ainsi 
que le code, mais augmente la complexite en utilisant des fichiers XML. 



L'interface de fabrique herite de ► 
javax.ejb. EJBHome. 

Cette methode permet d'instancier un entity ► 
bean et d'inserer ses donnees en base. 

Permet de retrouver un entity bean a partir d'un ► 
parametre (ici la cle). Le type de retour est 
l'interface metier. 

EJB Remote et Local 

Les entity beans 2.1 peuvent etre invoques de 
maniere distante ou locale. Selon le cas, l'interface 
de fabrique herite soit de EJBHome, soit de 
EJBLocalHome et l'interface metier de 
EJBObject ou de EJBLocal Object, Pour 
les appels locaux, les methodes ne lancent pas de 
RemoteException. 



L'interface metier herite de ► 
j avax . e j b . ED BOb j ect. 

Accesseurs des deux attributs de I'entity bean ► 
cle et valeur. 



L'exemple ci-apres utilise un CMP qui persiste des cles et des valeurs 
dans une table constituee de deux colonnes. 

Les entity beans 2.x sont constitues de deux interfaces et d'une classe. 
L'interface de fabrique (home interface) definit les methodes qu'un 
client peut invoquer pour creer, trouver ou supprimer un EJB. Etant 
donne que les EJB entity sont persistants, un client peut creer une ins- 
tance d'un composant (c'est-a-dire faire un insert dans la table) mais 
aussi en rechercher une existante (un ordre select). Notez que l'invoca- 
tion de ces methodes peut echouer, soit pour des raisons liees au reseau 
(RemoteException), soit pour des problemes d'acces a la base de donnees 
(CreateException, Fi nderException). 

Home interface de I'entity bean 

public interface HelloHome extends EJBHome { 

Hello create(String cle) throws RemoteException, 

CreateException; 

Hello findByPrimaryKey(String cle) throws RemoteException, 

FinderException; 

} 

L'interface metier permet de definir les services que propose le compo- 
sant. Elle definit les accesseurs des attributs du composant ainsi que 
d'eventuelles methodes metiers. Dans notre cas, sont definis les acces- 
seurs des attributs cl e et val eur. Notez que l'invocation de ces methodes 
peut echouer pour des raisons liees au reseau (les methodes lancent des 
RemoteException) ; nous manions par consequent ce que Ton appelle un 
composant distant. 

Interface metier de I'entity bean 

public interface Hello extends EJBObject { 

String getCle() throws RemoteException; 

String getValeur() throws RemoteException; 

void setValeur(String valeur) throws RemoteException; 

} 

La classe du bean n'implemente pas les interfaces que nous venons de 
definir, mais plutot l'interface Enti tyBean Q. Notez qu'un CMP ne pos- 
sede pas d'attributs et que les accesseurs sont declares asbtract Q. La 
signature de la methode ejbCreateO doit etre la meme que 
ejbPostCreate © et correspond a la methode createO declaree dans 
l'interface de fabrique. Les methodes permettant de gerer le cycle de vie 
du composant sont vides ©. 
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Classe d'implementation de I'entity bean 



public abstract class HelloBean implements EntityBean { Q 

public abstract String getCle() throws RemoteExcepti on ; 
public abstract void setCl e(Stri ng cle) throws © 

RemoteException ; 
public abstract String getValeurO throws RemoteException; 
public abstract void setVal eur(Stri ng valeur) throws 

RemoteException ; 

public String ejbCreate(Stri ng cle) throws RemoteException, 

CreateException { 

setCle(cle) ; 
return nul 1 ; 

} 

public void ejbPostCreate(Stri ng cle) throws CreateException{ 
} © 



public void setEnti tyContext(Enti tyContext entityContext) 

throws EJBException { } 
public void unsetEntityContext() throws EJBException { } 
public void ejbRemove() throws RemoveException, 

EJBException { } 
public void ejbActi vate() throws EJBException { } 
public void ejbPassi vate() throws EJBException { } 
public void ejbl_oad() throws EJBException { } Q 
public void ejbStore() throws EJBException { } 

} 

Comme vous pouvez le constater, il n'y a ni ordres SQL, ni attributs, ni 
colonnes ou tables dans lesquelles les donnees doivent persister. La plu- 
part de ces informations sont decrites dans le fichier norme ejb-jar.xml 
ainsi que dans des fichiers specifiques au conteneur d'EJB (jbosscmp- 
jdbc.xml pourJBoss). 

Dans le fichier ejb-jar.xml, on declare le nom de l'entity bean 0 ainsi 
que les interfaces © et classes d'implementation ©. La balise 
persistence-type © avertit le conteneur qu'il doit gerer la persistance 
(Container pour les CMP ou Bean pour les BMP). La cle primaire que 
nous utilisons est de type String ©. Dans les balises cmp-field ©, on 
declare les attributs (cle et valeur) du composant © puis on indique au 
conteneur lequel de ces attributs est la cle primaire ©. 



La classe de l'entity bean est abstraite. 



Les accesseurs sont abstraits et lancent une 
RemoteException. 



Chaque methode create de I'interface de 
fabrique doit avoir une methode ejbCreate 
dans la classe du bean. Notez que cette methode 
retourne la valeur nul 1 . 



Une methode ejbCreate doit avoir obligatoi- 
rement une methode ejbPostCreate qui 
permet d'executer du code apres avoir insere des 
donnees en base. 



Ces methodes de callback doivent etre imple- 
mentees meme si on ne les utilise pas. 
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Chaque entity bean 2.x doit etre defini dans le 
fichierejb-jar.xml. 



Les CMP deleguent la persistance au conteneur. ► 



Tous les attributs persistants doivent etre reper- 
tories dans cette section. 



La methode findByPrimaryKey s'appuie 
sur cette information. 



Source de donnees et type de base de donnees 
utilises pour la persistance. 



L'entity bean defini sous le nom HelloBean 
dans le fichier e j b- j ar . xml est persiste dans 
la table Hell o_Petstore. 



Fichier ejb-jar.xml 

<ejb-jar> 

<enterpri se-beans> 
<entity> 

<di spl ay-name>Hel 1 oEB</di spl ay-name> 
<ejb-name>HenoBean</ejb-name> 0 
<home>Hel 1 oHome</home> 0 
<remote>Hello</remote> 0 
<ejb-class>HelloBean</ejb-class> Q 

<persi stence-type>Contai ner</persi stence-type> © 
<prim-key-class>java. lang.String</prim-key-class> 0 
<reentrant>Fal se</reentrant> 
<cmp-versi on>2 .x</cmp-version> 

<abs tract- schema- name>Hello</abstract-schema-name>; 

<cmp-field> © 

<field-name>cle</field-name> 0 
</cmp-field> 
<cmp-field> 

<f i el d-name>val eur</f i el d-name> 0 
</cmp-fi el d> 

<pri mkey-f i el d>cl e</pri mkey-f i el d> © 

</enti ty> 
</enterpri se-beans> 
</ejb-jar> 

Le fichier jbosscmp-jdbc.xml effectue le mapping entre le composant et 
la base de donnees. Tout d'abord, ce fichier declare la source de donnees 
petstoreDS © que Ton va utiliser ainsi qu'un mapping propre a la base 
de donnees MySQL ©. On definit la table ou les donnees vont etre 
stockees ©, dans notre cas HELLO_PETSTORE, puis le mapping entre les 
attributs du composant et les colonnes de la table ©. 

Fichier jbosscmp-jdbcxml 

<jbosscmp-jdbc> 
<defaults> 

<datasource>java:/petstoreDS</datasource> © 
<datasource-mappi ng>mySQL</datasource-mappi ng> © 

</defaults> 

<enterpri se-beans> 
<entity> 

<e j b-name>Hel 1 oBean</ e j b-name> 

<tabl e-name>HELLO_PETSTORE</table-name> © 
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<cmp-field> © 

<f i el d-name>cl e</f i el d-name> 

<col umn-name>key</col umn-name> 

<jdbc-type>VARCHAR</jdbc-type> 

<sql-type>varchar(10)</sql-type> 
</cmp-field> 

<cmp-f i el d> © 

<f i el d-name>val eur</f i el d-name> 

<col umn-name>val ue</col umn-name> 

<jdbc-type>VARCHAR</jdbc-type> 

<sql -type>varchar(50)</sql-type> 
</cmp-field> 

</entity> 
</enterpri se-beans> 
</jbosscmp-jdbc> 

II faut ensuite compiler et packager tous ces fichiers dans un JAR pour 
pouvoir deployer l'EJB. II reste maintenant a developper une classe 
cliente qui pourra interagir avec ce composant. II n'y a pas d'injection en 
EJB 2.x, il faut done obligatoirement utiliser JNDI pour retrouver 
l'interface de l'entity bean 0 a partir du contexte initial Q. Dans cet 
exemple, on insere 0 des donnees en base a l'aide de la methode 
create(). La methode fi ndByPrimaryKey nous permet de retrouver le 
composant Q et d'en modifier les valeurs 0. Pour supprimer les don- 
nees de la base, on appelle la methode remove 0 de l'entity bean. 

Classe utilisant l'entity bean 

public class Main { 

public static void main(String[] args) { 
InitialContext ic = null; 
try { 

Properties props = new PropertiesO ; 

props . setProperty(" java. nami ng . factory. initial" , 

"org . j np . i nterf aces . Nami ngContext Factory") ; 
props . setProperty(" java. nami ng . factory. url . pkgs" , 

"org . jboss . nami ng :org . jnp . i nterf aces") ; 
props . set Property (" java . nami ng . provi der . url " , 

"localhost") ; 

ic = new InitialContext(props) ; 0 

Object objRef = (HelloHome) ic.lookup("ejb/Hello") ; 0 
HelloHome home = (HelloHome) 

Portabl eRemoteObject . narrow(objRef , HelloHome . cl ass) ; 

Hello hello = home.create("Hello") ; 0 
hello. setValeur("PetStore!") ; 

hello = home.findByPrimaryKeyC'Hello") ; 0 
System . out . pri ntl n (hel 1 o . getCl e () ) ; 
System .out . pri ntl n(hel lo . getVal eur()) ; 



L'attribut cl e est stocke dans la colonne key 
de type varchar(lO). 



L'attribut valeur est stocke dans la colonne 
val ue de type varchar (50) . 



< Proprietes pour acceder a I'annuaire JNDI de 
J Boss. 



< On recherche dans JNDI l'interface metier qui se 
nomme ejb/Hel lo. 



< On cree un entity bean avec les attributs 
« Hello » pour la cle et « PetStore! » pour la 
valeur. 

< Une fois cree, on le recherche a partir de sa cle 
primaire. Une fois obtenu, on affiche la valeur 
des attributs. 
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► hello. setValeur("PetStore Moch'fie!"); 0 

► hello. removeO ; 0 

} catch (Exception e) { 
e . pri ntStackTraceO ; 

} 

} 

} 

Comme vous pouvez le constater, les entity beans 2.x sont bien differents 
des Pojo annotes par JPA. lis utilisent le systeme d'interface de fabrique 
(qui rappelle l'entity manager) et sont en realite des classes abstraites sans 
attributs. De plus, les informations de mapping sont eparpillees dans plu- 
sieurs fichiers XML, ce qui rend les eventuelles erreurs difficiles a trouver. 



Un exemple de stateless bean 

Pour le stateless bean, que diriez-vous d'un composant qui retourne la 
chaine de caractere « Hello Petstore! » ainsi que la date du jour. Pour 
developper ce stateless session bean 2.x, il faut deux interfaces, une classe 
et un descripteur de deploiement. 

Une premiere interface de fabrique permet la construction (factory) d'un 
composant EJB. Dans notre cas, il s'agit d'une interface distante etant 
donne qu'EJBHome Q herite de l'interface java. rmi . Remote. Le nom 
d'une methode de creation est obligatoirement create 0. 

Home interface du stateless bean 

► public interface HelloHome extends EJBHome { 0 
Hello createO throws RemoteException, CreateException; 0 

} 

L'interface metier permet de definir les services que propose l'EJB, c'est-a- 
dire les methodes metiers qu'expose le composant (dans notre cas les deux 
methodes sayHel lo() et today ()). Notez que l'invocation de ces methodes 
peut echouer pour des raisons liees au reseau (RemoteException). 

Interface metier du stateless bean 

► public interface Hello extends EJBObject { 

► String sayHello() throws RemoteException; 
Date todayO throws RemoteException; 

} 
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En modifiant les attributs, on met a jour la base 
de donnees. 

L'entity bean est supprime ainsi que ses donnees 
en base. 



L'interface de fabrique herite de 
javax.ejb. EJBHome. 



L'interface metier herite de 
j avax . e j b . ED BOb j ect. 

Les methodes metiers permettant de retourner 
une chaine de caracteres et la date du jour. 



00 

□ 



Contrairement aux EJB 3, la classe d'implementation des EJB 2 
n'implemente pas l'interface metier. Notez aussi que les deux methodes 
metiers sayHel lo 0 et today 0 ne lancent pas de RemoteException alors 
qu'elles sont declarees comme telles dans l'interface metier. Les 
methodes permettant de gerer le cycle de vie du composant doivent etre 
implementees meme si elles ne sont pas utilisees 0. 

Classe d'implementation du stateless bean 

public class HelloBean implements SessionBean { 

public HelloBeanO { } 

public String sayHello() { 

return "Hello Petstore !"; 0 

} 

public Date today () { 
return new Date(); 0 

} 

public void ejbCreateO throws CreateException { } 0 
public void setSessionContext(SessionContext sessionContext) 

throws EJBException { } 
public void ejbRemoveO throws EJBException { } 
public void ejbActi vate() throws EJBException { } 
public void ejbPassi vate() throws EJBException { } 

} 

Tout comme Java EE, on peut demarquer les transactions dans les EJB 
stateless en tenant compte d'une politique transactionnelle qui peut etre 
geree soit manuellement, soit par le conteneur 0. Les annotations 
n'existant pas (@TransactionAttribute en EJB 3), la politique transac- 
tionnelle est specifiee 0 dans le descripteur de deploiement XML 
(fichier ejb-jar.xml). Ce fichier informe aussi le conteneur du nom des 
interfaces, de la classe metier 0 et aussi du type de composant Q, dans 
notre cas un composant session sans etat. 

Fichier ejb-jar.xml 

<ejb-jar> 

<enterpri se-beans> 
<session> 

<di spl ay-name>Hel 1 oSB</di spl ay-name> 
<ejb-name>Hel loBean</ejb-name> 

<home>Hel 1 oHome</home> 

<remote>Hel lo</remote> 0 

<e jb-cl ass>Hel 1 oBean</e j b-cl ass> 



Un EJB stateless 2.x herite 
javax.ejb. SessionBean. 



de 



Constructeur. 



Les methodes metier. 



Les methodes callback. 



Nom de I'EJB. 



Nom de l'interface de fabrique, de l'interface 
metier et de la classe d'implementation. 
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UJ 

g 

JO 

<session-type>Statel ess</session-type> Q 
<transacti on-type>Contai ner</transaction-type> (j) 

</session> 

<assembly-descriptor> 
<container-transaction> 
<method> 

<ejb-name>Hel loBean</ejb-name> 
<method-name>*</method-name> 
</method> 

<trans-attribute>Requi red</trans-attri bute> © 
</contai ner-transaction> 
</assembly-descri ptor> 

</enterpri se-beans> 
</ejb-jar> 

Un autre fichier de description propre au serveur d'applications (dans 
notre cas jboss.xml), permet de donner un nom JNDI a l'EJB afin qu'il 
puisse etre appelable par un client. Le composant Hel loBean © se nomme 
done ejb/Hel lo ©. 

Fichier jboss.xml 

<jboss> 

<enterpri se-beans> 
<session> 

<ejb-name>HelloBean</ejb-name> © 

<jndi -name>ejb/Hello</jndi -name> © 
</session> 
</enterpri se-beans> 
</jboss> 

II faut ensuite compiler les classes et les packager avec les descripteurs 
XML dans un JAR pour pouvoir deployer l'EJB. Pour interagir avec ce 
composant, il faut developper une classe cliente qui utilise JNDI pour 
retrouver l'interface du session bean Q. Une fois l'interface obtenue, on 
peut appeler les methodes metier Q. 

Classe utilisant le stateless bean 

public class Main { 

public static void main(String[] args) { 
InitialContext ic = null; 
try { 

Properties props = new Properti es() ; 
props . set P rope rty("java. nami ng . factory. i ni ti al " , 

"org . j np . i nterf aces . Nami ngContext Factory") ; 
props . set P rope rty(" java. nami ng . factory . url . pkgs" , 

"org . j boss . nami ng : org . jnp . i nterf aces") ; 
props . set P rope rty(" java. nami ng . provider . url " , 

"localhost") ; 



= L'EJB est stateless et la demarcation des transac- 
I tions est assuree par le conteneur. 



La politique transactionnelle utilisee pour toutes 
les methodes de ce session bean est 
Requi red. 



Nom JNDI du stateless session bean. ► 



Proprietes pour acceder a I'annuaire JNDI de ► 
JBoss. 
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ic = new InitialContext(props) ; Q 

Object objRef = (HelloHome) ic.lookup("ejb/Hello") ; 

HelloHome home = (HelloHome)PortableRemoteObject. narrow 

(objRef, HelloHome. class) ; 
Hello hello = home . create () ; 

System . out . pri ntl n (hel 1 o . sayHel 1 o () ) ; 
System. ou t.println (hello. today ()) ; Q 

} catch (Exception e) { 
e.printStackTrace() ; 

} 



On recherche dans JNDI I'interface metier qui se 
nomme « ejb/Hello ». 



On appelle les deux methodes metiers. 



En resume 

La specification 3 des EJB a ete elaboree en vue de simplifier la concep- 
tion d'EJB pour le developpeur. Les avantages sont les suivants : 

• une architecture basee sur les Pojos et non plus sur les composants ; 

• une API pour le mapping objet/relationnel (JPA) ; 

• moins de classes et d'interfaces a implementer (plus besoin d'heriter 
d'une super interface ou classe) ; 

• utilisation des annotations a la place des descripteurs de deploiement 
XML devenus optionnels ; 

• avec le systeme d'injection, les JNDI lookups ne sont plus 
necessaires ; 

• une gestion du cycle de vie simplifiee. 
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Developpement 
avec IntelliJ IDEA 



Reference IntelliJ IDEA 

IntelliJ IDEA est un IDE cree par la societe Jet- 
Brains. 

► http://www.jetbrains.com/idea/ 



IntelliJ IDEA est un environnement de developpement integre (IDE) qui 
facilite le developpement duplications Java EE en vous fournissant un 
support etendu sur une grande variete de frameworks et de technologies. 

IntelliJ IDEA vous offre un ensemble d'outils qui simplifient le pro- 
cessus de developpement, en vous fournissant notamment une aide a la 
programmation avec completion de code intelligente, des avertissements 
d'erreurs a la volee, des diagrammes d'entites-relations pour la modera- 
tion, du remaniement de code (refactoring), de la generation automa- 
tique de code, etc. 

Dans les projets ou il est necessaire d'employer de multiples technologies 
et frameworks, IntelliJ IDEA vous fournit un niveau de support inegale 
en integrant tous ces outils de maniere coherente. IntelliJ IDEA vous 
donne egalement la flexibilite de decrire la structure de votre application 
(via les annotations ou les descripteurs XML) afin de manipuler ce 
melange de technologies de maniere integree. 

Les assistants au developpement sont disponibles aussi bien pour Java que 
pour XML, SQL, JSP, HTML et tout autre code dont vous pourriez 
avoir besoin dans vos projets. IntelliJ IDEA detecte le langage dont vous 
avez besoin et vous fournit une aide adequate. Par exemple, la ou vous 
devez editer un ordre SQL, vous aurez de la completion de code SQL. 

Lediteur JSP (Java Server Pages) vous assiste pratiquement dans tout ce 
dont vous pourriez avoir besoin pour creer une interface utilisateur : il 
reconnait les frameworks et les balises que vous utilisez, verifie le code, 
repare les erreurs frequentes et s'integre avec divers outils comme le dia- 
gramme visuel JSF (Java Server Faces) . 



Cette annexe se propose de vous montrer comment developper une 
application web permettant a un utilisateur de modifier les donnees d'un 
client et de son adresse en utilisant Java Persistence API (JPA) et JSF. 



Un projet fa^on IntelliJ IDEA 

IntelliJ IDEA vous laisse controler la configuration de votre projet par 
l'emploi de « facettes ». Chaque facette supporte une technologie ou un 
framework particulier. Une fois quelle est ajoutee a votre projet, vous 
avez acces aux divers outils d'lntellij IDEA ainsi qu'aux editeurs de code 
prets a l'emploi. 

Certaines facettes, comme JSF, ont besoin d'une facette parent (facette 
web). Dans ce cas, la facette web permet de supporter les servlets, les 
descripteurs de deploiement, la configuration XML, etc. 

Creer et configurer le projet 

Pour creer un projet, lancez IntelliJ IDEA et cliquez sur Create New Project 
sur l'ecran de demarrage ou dans le menu File>New Project (figure E-l). 



Figure E-1 

Creation d'un projet 
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31 #AM**t J «wu»t API 
Jj Ant Support 



91 CVS Integration 
u~- .-..j ■■■■■■■ ■■>-■ 



91 Inmnundw 

l>i**lm fl twr> miW vm< fw rv»v*>«rTO 



9| IISIAiJyui 

f*0"-**»* Dependency Srurtwe Hwrt* (DSN) 



L'assistant de projet apparait alors. II est possible de creer un projet a 
partir de code existant ou a partir de zero. C'est cette derniere option 
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que nous allons choisir : selectionnez Create project from scratch et cli- 
quez sur Next (figure E-2). 
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lntelllJlDE/\ 



NEW 

project 



® Create project from scratch 

Create new IDEA project structure 

0 Creole Java prujeit from exrttNiy *uur<_e» 

Creete IITA prnjm-r d-mrtirft nv*r rv.ia>irv) w»rf« 

□ Import project fiom external model 

Create IDEA project structure over existing external model ( J&jkfcr , f 



Figure E-2 

Creation d'un projet a partir de rien 



Ici nous specifions le nom du projet (Yaps Customer Management) et 
demandons a IntelliJ IDEA d'utiliser le module Java (Java Module) 
(figure E-3). 




Name: 

Content toot. 
Module location: 

iclcct type 
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Figure E-3 

Creation du projet de gestion des clients 



Choisissez le repertoire oil sera stocke le projet ainsi que le code source 
(par defaut src), et cliquez sur Next. Vbus arrivez sur un ecran oil il faut 
specifier les technologies et frameworks utilises dans le projet (figure E-4). 



Figure E-4 

Selectionnez les technologies 
utilisees par le projet. 
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View as: [® Java EE: Structure 
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*4 Hibernate Facets 
Q JavaEE Application Facets 
3 JPA Facets 

[±r- 0 Yaps Customer Management 



d EJB Facets 
6- Web Facets 

6- (3 Web (in Yaps Customer Management) 

- $ web.xml 

— E^Yaps Customer Management 

( h fijj Faces Servlet (/fxes/';'.fxes) 
EB- S '«eb 

Figure E-5 

Structure du projet 



Pour la persistance Java EE (c'est-a-dire JPA), selectionnez TopLink et, 
pour l'application web, JSF Sun 1.2. Cliquez enfin sur Finish. IntelliJ 
IDEA creera et configurera automatiquement le projet, les facettes, et 
telechargera les bibliotheques necessaires pour les aj outer dans le reper- 
toire lib (repertoire par defaut). 

Le projet est cree. Dans la fenetre de gauche, vous pouvez changer le 
mode d'affichage (liste deroulante intitulee View as) pour voir la struc- 
ture Java EE (choisissez Java EE : Structure) (figure E-5). Comme vous 
pouvez le constater, les fichiers de configuration web (web.xml et faces- 
config.xml) ont ete crees, ainsi que ceux de la persistance 
(persistence, xml). 

II nous faut maintenant creer les elements de l'application Yaps Cus- 
tomer Management. 



Creer les elements de Implication 

Avant toute chose, il nous faut renommer l'unite de persistance par defaut 
NewPersi stenceUni t en petstorePU. Pour cela, selectionnez l'unite de per- 
sistance, pressez les touches Shift+F6 et saisissez petstorePU (figure E-6). 
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□ x_ 





IpetstorePU 
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□ Search in cor 


nrnents and strings 






Pefacto, 


Preview || Cancel || 


Help 



Figure E-6 

Renommez I'unite de persistance. 



Cliquez sur Refactor. Comme le projet ne contient pas encore de code, 
IntelliJ IDEA a simplement renomme I'unite de persistance. S'il y avait 
deja eu des references a cette unite, elles auraient ete mises a jour. 

II est temps desormais d'ajouter des entities a cette unite de persistance. 



Creer l'entity Address 

La creation d'un entity est extremement simple : faites un clic droit sur 
I'unite de persistance petstorePU, selectionnez le menu New, puis cliquez 
sur Entity. IntelliJ IDEA vous demande alors le nom de l'entite (saisissez 
Address) ainsi que son paquetage cible (com. yaps. petstore. entity). 

L'entity ainsi cree, on peut rajouter des attributs en faisant un clic droit 
sur cet entity Address puis en selectionnant le menu New. S'affiche alors 
la liste des attributs possibles. 

Commencons par creer un identifiant (selectionnez New puis id). IntelliJ 
IDEA affiche une boite de dialogue nous permettant de specifier le nom du 
champ (id) ainsi que son type (java. Tang. Long) (figure E-7). Notez que 
vous pouvez appuyer sur Ctrl+Espace pour obtenir la completion sur le type. 



Name |id 
Type |java,lanq,| 



I 'ft Iteral)le<T> 
'>) ft LinkageEEEOE 



ft Hath 

ft MegativeAEEaySizeException 
'f) ft NoClassDef FoundEEEOE 
fjft NoSuchFieldEEEOE 
1 £> ft NoSuchFieldException 
•fiTa NoSuchHethodEEEOE 
Q ft NoSuchHethodException 



Figure E-7 

Creation de I'identifiant de I'adresse 



Vous pouvez constater qu'lntellij IDEA a genere l'attribut id ainsi que 
les methodes d'acces get et set. 



2>q % ft* aa z; ► ♦ 4 ^ 



File Edit Search View Go To Code Analyze Ref actor Build Run J_ools Version Control Window Help 
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I 



gQk ft A * » 

View as: IS Java EE: Structure 



* 4 Hibernate Facets 
Ci] JavaEE Application Facets 
P JPA Facets 

EJ- SSI Yaps Customer Management 

i[x] persistence, xml 
Cfi petstorePU 

Eh ^Address aps petirs-e 

L'^id 
d EJB Facets 
Eh Web Facets 

Eh Web (in Yaps Customer Management) 

■ £t] web. xml 

■ E<JYaps Customer Management 
[ 3- QFaces Servlet (/faces/*;*. faces) 
±- E9 web (/) 



; package com. yaps. petstone. entity; 

irijort navax. persistence. Entity; 
diu^ort javax. persistence. Id; 



a 



SEntity 

puhlic class Address { 
private Long id; 

Bid 

public Long getld() { 
return id; 

} 

public void set.Id(Long id) { 
this. id = id; 




[JUljllL Lloss Addicts { 

PUT, 

Bid Bv;MHWtfV»lV 
public Long g.tld(> | 
return id; 

) 

piiMir void Mtldtteng 1rtJ ( 
this. id = id: 



Figure E-9 Import automatique 
de I'annotation ©GeneratedValue 



Figure E-8 Entity Address avec identifiant, getter et setter 

Cet identifiant doit etre genere automatiquement. Pour cela, il suffit de 
l'annoter avec @GeneratedVa"lue. 

IntelliJ IDEA a surligne I'annotation car elle est encore inconnue. En 
revanche, il se propose de l'importer automatiquement (figure E-9). 
Pour cela, appuyez sur Alt+Entree et vous verrez l'ajout de la ligne i mport 
javax. persistence. GeneratedVal ue ; en haut de la classe. 

Utilisez l'assistant pour creer les autres attributs de l'entity Address : 
streetl, street2, city, state, zipcode et country; ces attributs sont 
tous de type String. 
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Methodes de callback 

Maintenant que nous avons tous les attributs de l'entity Address, il nous 
faut aj outer les methodes de callback pour nous assurer de la validite des 
donnees avant insertion (@PrePersist) et mise a jour (@PreUpdate). 
Appuyez sur les touches Alt+lns et selectionnez les methodes de callback 
partir du menu Entity Listener Methods (figure E-10). 

Saisissez le code de validation dans la methode annotee val i dateData. 
Profitez en pour surcharger les methodes equals et hashCode a partir du 
meme menu Generate (touches Alt+lns) (figure E-ll). 
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Figure E-10 

Selection des methodes de callback 
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View as: | [j] Java EE: Structure 
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'Cj Address, java 

package com. yaps. petstore. entity; 

iu^ort javax. persistence. *; 



SEntity 

public class Address 



J Id 



?dValu 



private Long id; 
private String streetl; 
private String street2; 
private String city; 
private String state; 
private String zipcode; 
private String country; 

@PrePersist 
SPreUpdate 

private void validateData( ) { 

if (streetl == null I I "". equals (streetl) ) 

throw new RuntimeException(" Invalid street" } ; 
if (city == null I I " " . equals (city) ) 

throw new RuntimeException(" Invalid city" ) ; 
if (zipcode == null || "". equals (zipcode) ) 

throw new RuntimeException(" Invalid zip code" 
if (country == null I I "". equals (country) ) 

throw new RuntimeExceptionf" Invalid country" ) 

} 

public Long getldf) { 
return id; 

} 

public void setldfLong id) { 



#3*3 



| Insert £6 Default 



Figure E-1 1 Entity Address avec attributs et methode de validation 
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Repetez ces meme actions pour creer l'entity Customer (client) avec les 
attributs id, login, password, f i rstname, lastname, telephone, email, 
dateOf Bi rth et age. Pour creer la relation entre le client et son adresse de 
domiciliation, nous allons utiliser un diagramme d'entites-relations. 



Figure E-12 

Diagramme d'entites-relations 



Figure E-13 

Propriete de la relation 
entre Customer et Address 



Diagramme d'entites-relations de JPA 

Apres avoir cree les entities Customer et Address, nous devons specifier 
leurs relations. Pour cela, nous pouvons utiliser le diagramme d'entites- 
relations d'lntellij IDEA. II est en effet plus facile de faire des liens de 
maniere visuelle. 

Faites un clic droit sur l'unite de persistance, puis choisissez le dia- 
gramme d'entites-relations (Open ER Diagram). IntelliJ IDEA affiche 
alors les entities definis dans l'unite de persistance (figure E-12). 
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Pour creer un lien unidirectionnel entre les deux entities, cliquez sur 
Customer et deplacez la souris vers Address. IntelliJ IDEA affiche une 
boite de dialogue vous laissant specifier les proprietes de la relation. Sai- 
sissez le nom du nouvel attribut (homeAddress) qui sera cree dans la 
classe Customer, puis cliquez sur OK (figure E-13). 
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Cascade Type: 



□ merge 

□ pers-st 
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Comme vous pouvez le constater, IntelliJ IDEA a cree et annote le 
nouvel attribut. 



Creer I' interface JSF 

Maintenant que le modele de donnees est pret, nous devons creer l'inter- 
face web permettant aux utilisateurs de creer, afficher et modifier les 
donnees de leurs clients. Pour cela, nous utiliserons le generateur de 
pages JSF. 

Faites un clic droit sur i'unite de persistance petstorePU et selectionnez 
le menu Generate Faces Pages. Cette option nest disponible que quand la 
facette JSF est correctement configuree et ajoutee au module, ce que 
nous avons fait lors de la creation du projet. IntelliJ IDEA affiche alors 
une boite de dialogue vous laissant choisir le code que vous voulez 
generer (via des templates totalement ajustables) (figure E-14). 
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Generate Java Server Faces 

Automoticaly create the JSF application that can be used to view and modify data through the Web interface. 
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Figure E-14 

Generation des pages 
pour client et adresse 
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Selectionnez le dossier ou vous voulez placer les pages JSP generees 
(repertoire web), le paquetage des managed beans 
(com. yaps. petstore. jsf) ainsi que le suffrxe utilise pour les managed 
beans (Controller). Selectionnez le nom du fichier de configuration JSF 
(faces-config.xml) qui contiendra les informations sur la structure (les 
validateurs, les beans, les regies de navigation, etc.). 

La table Entities affiche la liste des entities ainsi que les pages JSP dont 
vous avez besoin (pour creer, editer, consulter, lister). Sous cette table, 
vous pouvez voir l'editeur de code montrant les elements qui vont etre 
generes. Entierement personnalisable, cet editeur vous permet de modi- 
fier le code comme vous le souhaitez. Cliquez sur Generate. 
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View as: |C1 Java EE: Structure 
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Figure E-15 Edition du fichier faces-config.xml 
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Les pages JSP sont alors creees, ainsi que les managed beans. Double-cli- 
quez sur le fichier faces-config.xml pour ouvrir l'editeur (figure E-15). 
Vous pouvez alors modifier les convertisseurs, les managed beans, les 
regies de navigation et tous les autres elements de configuration JSF. 
L'onglet de navigation vous montre le diagramme de navigation. Grace a 
ce diagramme, vous pouvez directement passer des elements visuels 
(page, navigation...) au code (figure E-16). 
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Figure E-16 Navigation entre les pages JSP 
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LU 
UJ 

I 

1 Deployer et executer ('application 

I Le code enfin ecrit, il faut maintenant le deployer dans GlassFish pour 

^ utiliser l'application. IntelliJ IDEA integre nativement une tres large 

"S variete de serveurs d'applications, vous permettant de facilement 

1 deployer, executer et deboguer les applications Java EE. 

J Les serveurs d'application sont configures via le menu Run > Edit Confi- 

gurations. La, vous trouverez toute la configuration necessaire pour 
deployer, executer et deboguer l'application (figure E-17). Cliquez sur le 
bouton + puis choisissez Glassfish et Local. Vous pouvez aussi choisir 
Remote si le serveur sur lequel vous voulez deployer tourne sur une 
machine distante. 



Figure E-17 

Selection du serveur GlassFish 



3i Run/Debug Confi 
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button to create a 
ation based on default 
edit defaults, press 



Add New 'Glassfish Server' Configuration 




0 Display settings before launching 



Une fenetre de configuration s'affiche (figure E-18). Tout d'abord, sai- 
sissezle nom de la configuration, par exemple, GlassfishConfiguration. 
Dans l'onglet Server, cliquez sur Configure et specifiez le repertoire d'ins- 
tallation de GlassFish. IntelliJ IDEA detecte alors la version du serveur. 
Selectionnez la facette JSF a deployer ainsi que le domaine par defaut de 
GlassFish (domainl). Pour ce qui est de la page d'accueil, choisissez 
http : // 1 ocal host : 8080/yaps. 
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Figure E-18 Configuration du serveur GlassFish 

Cliquez sur OK pour sauvegarder la configuration. II ne vous reste plus 
qua demarrer GlassFish et a deployer 1' application. Pour cela, vous 
pouvez appuyer sur les touches Shift+F10. IntelliJ IDEA reaffiche la con- 
figuration du serveur avant d'executer l'application, de sorte que vous 
puissiez apporter des modifications. 

Cliquez ensuite sur Run. IntelliJ IDEA compile l'application, demarre 
GlassFish, cree les fichiers de deploiement, les deploie puis execute 
l'application en demarrant un navigateur. Toutes les traces de ces opera- 
tions apparaissent alors dans la console d'lntellij IDEA, ce qui facilite le 
monitoring de l'application (figure E-19). 

II ne vous reste plus qua vous rendre a l'adresse http : //l ocal host : 8080/ 
yaps/i ndex . faces pour pouvoir utiliser l'application et ainsi creer, modi- 
fier et lister les clients et adresses du systeme (figure E-20). 
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Figure E-19 Traces du serveur GlassFish dans IntelliJ IDEA 
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En resume 

Les fonctionnalites d'lntellij IDEA decrites ici concernent le support de 
Java EE 5. En effet, un IDE integre et robuste peut augmenter la pro- 
ductivite des developpements. Mais il y a encore beaucoup plus a 
explorer dans IntelliJ IDEA, puisqu'on observe la meme simplicite 
d'utilisation pour les EJB, les services web, Ajax, etc. 

IntelliJ IDEA est sans doute a l'heure qu'il est la solution la plus aboutie 
en matiere d' assistance aux projets de developpement. En effet, au vu de la 
taille et de la complexite que peuvent atteindre ces projets aujourd'hui, on 
ne saurait negliger l'importance d'un bon outil d'accompagnement alliant 
puissance, flexibilite et intelligence pour une productivite optimale. 
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Java EE 5 

EJB 3.0 • JPA • JSP • JSF • Web Services (JAXB, JAX-WS) • JauaMail • JMS • GlassFish • Ant • Derby 

Ce cahier detaille la conception d'un site de e-commerce avec UML et 
Java Enterprise Edition 5. Inspiree du Java Petstore, I'etude de cas se 
construit au fil des chapitres en appliquant les specifications Java EE 5 : 
EJB 3.0, JPA 1.0, Servlet 2.5, JSP 2.1, JSF 1.2, Web Services 1.2, 
JAXB 2.0, JAX-WS 2.0, JavaMail 1.4, JMS 1.1. L'application est deployee 
dans le serveur GlassFish et utilise la base de donnees Derby. 

Cet ouvrage s'adresse aux architectes et developpeurs confirmes qui veulent 
decouvrir les nouveautes de Java EE 5 ou migrer leurs applications J2EE 1 .4 
existantes. II montre comment s'imbriquent les differentes API de Java EE 5 
dans une application internet-intranet. 
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